本文记录了远程为两台 Mac（Apple Silicon）安装 OpenClaw 的完整过程，包含踩坑经验和最佳实践。

前言

OpenClaw 是一个强大的 AI 助手框架，支持多模型切换、工具调用、记忆系统等高级功能。本文分享如何个人openclaw远程为 Mac 用户安装和配置 OpenClaw，无需用户手动操作。

适用场景：

• 为家人/朋友远程部署 AI 助手

• 团队协作环境搭建

• 多台设备统一管理

环境准备

Mac 端前置条件（重要！）

1. 开启远程登录

Mac 默认关闭 SSH，需要手动开启，：

• 系统设置 → 通用 → 共享 → 打开「远程登录」

• 记下 IP 地址（系统设置 → 网络 → Wi-Fi/以太网）

• 确认用户名和密码提供给本地openclaw

2. 已安装 Xcode Command Line Tools（openclaw可以安装）

xcode-select --install

3. 已安装 Homebrew（openclaw可以安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. Node.js 22.22.3+ / 24.15+ / 25.9+（openclaw可以安装）

brew install node

安装步骤

1. 安装 Node.js

# 在 Mac 上执行 brew install node

踩坑记录： 如果遇到 SSL 证书问题（UNABLE_TO_GET_ISSUER_CERT_LOCALLY），需要临时关闭 npm 的 strict-ssl：

npm config set strict-ssl false

2. 安装 OpenClaw

npm install -g openclaw@latest

验证安装：

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 status

5. 打开 Dashboard

openclaw 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 2>&1

一键恢复脚本

创建 ~/.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', username='user', password='pass') # 执行远程命令 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 命令，自动带 token

3. 模型不显示深度思索开关

问题： Dashboard 上没有 reasoning 开关

原因： 模型配置中 reasoning: false

解决： 所有模型都设置 reasoning: true

4. 配置文件修改不生效

问题： 修改 openclaw.json 后 Dashboard 没变化

解决： 需要重启 Gateway openclaw gateway restart

最佳实践

1. 独立 API Key：每台 Mac 使用独立的 API key，避免共享

2. 定期备份：每日自动备份配置文件，保留 7 天

3. 进程守护：启用 LaunchAgent 的 KeepAlive 功能

4. 桌面快捷方式：提供 Dashboard 和恢复工具的一键启动

总结

通过本文的方法，可以远程为 Mac 用户完整部署 OpenClaw，包括：

• ✅ 自动启动 + 进程守护

• ✅ 每日备份 + 一键恢复

• ✅ 桌面快捷方式

• ✅ 多模型配置 + 深度思索

整个过程无需用户手动操作，适合远程技术支持场景。

---

• OpenClaw 官方文档：https://docs.openclaw.ai

• GitHub：GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞 · GitHub

• 软件库：https://freeshelf.cn