本文记录了远程为两台 MacApple Silicon安装 OpenClaw 的完整过程包含踩坑经验和最佳实践。前言OpenClaw 是一个强大的 AI 助手框架支持多模型切换、工具调用、记忆系统等高级功能。本文分享如何个人openclaw远程为 Mac 用户安装和配置 OpenClaw无需用户手动操作。适用场景为家人/朋友远程部署 AI 助手团队协作环境搭建多台设备统一管理环境准备Mac 端前置条件重要1. 开启远程登录Mac 默认关闭 SSH需要手动开启系统设置 → 通用 → 共享 → 打开「远程登录」记下 IP 地址系统设置 → 网络 → Wi-Fi/以太网确认用户名和密码提供给本地openclaw2. 已安装 Xcode Command Line Toolsopenclaw可以安装xcode-select --install3. 已安装 Homebrewopenclaw可以安装/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)4. Node.js 22.22.3 / 24.15 / 25.9openclaw可以安装brew install node安装步骤1. 安装 Node.js# 在 Mac 上执行 brew install node踩坑记录 如果遇到 SSL 证书问题UNABLE_TO_GET_ISSUER_CERT_LOCALLY需要临时关闭 npm 的 strict-sslnpm config set strict-ssl false2. 安装 OpenClawnpm install -g openclawlatest验证安装openclaw --version # 输出OpenClaw 2026.7.1-2 (0790d9f)3. 配置 OpenClaw创建配置文件 ~/.openclaw/openclaw.json{ agents: { defaults: { workspace: /Users/用户名/.openclaw/workspace, model: { primary: provider/qwen3.6-plus }, models: { provider/qwen3.6-plus: {alias: QP3.6}, provider/qwen3.7-plus: {alias: QP3.7}, provider/glm-5.2: {alias: GLM5}, provider/qwen3.7-max: {alias: QMax} }, timeoutSeconds: 600 } }, gateway: { mode: local, auth: { mode: token, token: 你的token }, port: 18789, bind: loopback }, models: { mode: merge, providers: { provider: { baseUrl: https://your-api-endpoint/v1, api: openai-completions, apiKey: 你的API密钥, models: [ { id: qwen3.6-plus, name: qwen3.6-plus, reasoning: true, contextWindow: 1000000, maxTokens: 65536 } ] } } } }重要提示reasoning: true 启用深度思索模式Dashboard 上会显示开关所有模型都建议设置 reasoning: true即使模型本身不支持4. 启动 Gateway# 安装为系统服务开机自启 进程守护 openclaw gateway install # 启动 openclaw gateway start # 查看状态 openclaw status5. 打开 Dashboardopenclaw dashboard这会自动打开浏览器并带上认证 token。自动化配置开机自启 进程守护OpenClaw 的 LaunchAgent 自带 KeepAlive 功能进程崩溃会自动重启。每日自动备份创建备份脚本 ~/.openclaw/scripts/backup.sh#!/bin/bash BACKUP_DIR$HOME/.openclaw/config-backup DATE$(date %Y%m%d_%H%M%S) mkdir -p $BACKUP_DIR cp $HOME/.openclaw/openclaw.json $BACKUP_DIR/openclaw_$DATE.json cp $HOME/.openclaw/agents/main/agent/models.json $BACKUP_DIR/models_$DATE.json # 保留最近 7 个备份 cd $BACKUP_DIR ls -t openclaw_*.json | tail -n 8 | xargs rm -f ls -t models_*.json | tail -n 8 | xargs rm -f添加 crontab每天凌晨 2 点备份0 2 * * * /Users/用户名/.openclaw/scripts/backup.sh ~/.openclaw/logs/backup.log 21一键恢复脚本创建 ~/.openclaw/scripts/restore.sh#!/bin/bash BACKUP_DIR$HOME/.openclaw/config-backup echo 可用备份 ls -t $BACKUP_DIR/openclaw_*.json | head -10 read -p 输入备份时间戳: TIMESTAMP cp $BACKUP_DIR/openclaw_$TIMESTAMP.json $HOME/.openclaw/openclaw.json cp $BACKUP_DIR/models_$TIMESTAMP.json $HOME/.openclaw/agents/main/agent/models.json openclaw gateway restart echo 恢复完成桌面快捷方式创建 OpenClaw-Dashboard.command 放到桌面#!/bin/bash export PATH/opt/homebrew/bin:$PATH eval $(/opt/homebrew/bin/brew shellenv 2/dev/null) openclaw dashboard --yes双击即可打开 Dashboard。远程安装工具使用 Python paramiko 实现完全远程安装import paramiko client paramiko.SSHClient() client.connect(192.168.2.x, usernameuser, passwordpass) # 执行远程命令 stdin, stdout, stderr client.exec_command(openclaw --version) print(stdout.read().decode()) # 传输文件 sftp client.open_sftp() sftp.put(local_config.json, /Users/user/.openclaw/openclaw.json) sftp.close()踩坑记录1. API Key 被截断问题 在脚本中硬编码 API key写入 Mac 后变成 ***3 字符原因 系统安全机制自动脱敏敏感信息解决 将 key 存到文件脚本从文件读取2. Dashboard 无法登录问题 直接 open http://127.0.0.1:18789/ 没有认证解决 使用 openclaw dashboard 命令自动带 token3. 模型不显示深度思索开关问题 Dashboard 上没有 reasoning 开关原因 模型配置中 reasoning: false解决 所有模型都设置 reasoning: true4. 配置文件修改不生效问题 修改 openclaw.json 后 Dashboard 没变化解决 需要重启 Gateway openclaw gateway restart最佳实践独立 API Key每台 Mac 使用独立的 API key避免共享定期备份每日自动备份配置文件保留 7 天进程守护启用 LaunchAgent 的 KeepAlive 功能桌面快捷方式提供 Dashboard 和恢复工具的一键启动总结通过本文的方法可以远程为 Mac 用户完整部署 OpenClaw包括✅ 自动启动 进程守护✅ 每日备份 一键恢复✅ 桌面快捷方式✅ 多模型配置 深度思索整个过程无需用户手动操作适合远程技术支持场景。OpenClaw 官方文档https://docs.openclaw.aiGitHubGitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. · GitHub软件库https://freeshelf.cn