OpenClaw 安装教程（macOS）

本页介绍在 macOS 上手动安装 OpenClaw 并接入 AI通道。

0. 前置：Node.js 22+

node --version

低于 v22.0.0 请先参考 Node.js macOS 安装指南 升级。

1. 安装 OpenClaw

执行上游官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

完成后验证：

openclaw --version
openclaw doctor

2. 初始化（Onboard）

openclaw onboard --install-daemon

向导推荐选择：

• On boarding mode：Manual
• Model auth provider：Skip for now
• How do you want to hatch your bot：Local，端口 18789
• 其余选项保持默认

3. 配置 OpenClaw（接入 AI通道）

3.1 配置文件位置

~/.openclaw/openclaw.json

3.2 获取 AI通道 Key

在 aitongdao.com 创建令牌，按场景选分组：Claude 用 claude/ccmax，GPT 用 codex，Gemini 用 gemini。

3.3 写入配置文件

mkdir -p ~/.openclaw
cat > ~/.openclaw/openclaw.json <<'EOF'
{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://ai.aitongdao.com/v1",
        "api": "openai-responses",
        "apiKey": "sk-你的密钥",
        "models": [
          { "id": "gpt-5", "name": "GPT-5" }
        ]
      },
      "anthropic": {
        "baseUrl": "https://aitongdao.com",
        "apiKey": "sk-你的密钥",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      }
    }
  }
}
EOF

3.4 配置解释

支持的常见模型：

• openai/gpt-5
• anthropic/claude-sonnet-4-6
• anthropic/claude-opus-4-6
• google/gemini-2.5-pro（需要另外配置 google provider）

注意事项：

• OpenAI provider 的 baseUrl 带 /v1，api 字段必须是 openai-responses。
• Anthropic provider 的 baseUrl 不带 /v1，不需要 api 字段。
• models 字段是数组，可追加多个模型条目。
• primary 使用 provider/model-id 的写法。

4. 重启网关并验证

openclaw gateway restart
openclaw status
openclaw doctor
openclaw dashboard

dashboard 默认在 http://localhost:18789 打开，在界面里发一条测试消息即可确认。

5. 如何切换模型

修改 agents.defaults.model.primary 的值，例如切到 GPT-5：

"primary": "openai/gpt-5"

保存后执行 openclaw gateway restart。

常见问题

• command not found：openclaw 二进制未加入 PATH，关闭终端重开；或检查 ~/.openclaw/bin 是否在 $PATH。
• 写入失败：chmod -R u+w ~/.openclaw 修复权限；或改用编辑器手动保存。
• 网关启动失败：lsof -i :18789 查看端口占用，必要时 kill 占用进程；或执行 openclaw doctor 获取详细诊断。
• API 调用 401：apiKey 复制不全或令牌已被删除，重新到令牌页面创建。
• API 调用 404 / 模型找不到：OpenAI provider 的 baseUrl 必须带 /v1；模型 id 字段拼写需与 AI通道 后台「可用模型」列表一致。