OpenClaw 安装教程（macOS）

0. 前置：Node.js 22+

先装 Node.js：Nodejs macOS

重要提示：OpenClaw 对 Node 版本比较敏感，建议安装 Node.js 22 或更新版本。

1. 安装 OpenClaw

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：复制下面这行命令，粘贴到终端里，按回车：

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

第三步：验证安装是否成功。分别执行下面两个命令：

openclaw --version

openclaw doctor

如果看到版本号和检查结果，说明安装成功了。

2. 初始化（Onboard）

什么是初始化？ 初始化就是让 OpenClaw 在你的电脑上创建一个后台服务，这样你就可以通过网页或命令行来使用 AI 了。

第一步：在终端里执行初始化命令：

openclaw onboard --install-daemon

第二步：按照提示选择配置（新手直接按下面的选）：

1. Onboarding mode（初始化模式）：选 Manual（手动配置）

   • 用方向键 ↑↓ 选择，按回车确认

2. What do you want to set up?（要设置什么？）：选 Local gateway (this machine)（本地网关）

   • 意思是在你自己的电脑上运行服务

3. Gateway port（网关端口）：输入 18789 或直接按回车用默认值

   • 这是服务运行的端口号，不用改

4. Gateway auth（网关认证）：选 Token（令牌认证）

   • 建议开启，这样更安全

3. 配置 OpenClaw（接入词元AI）

3.1 配置文件在哪里？

配置文件路径：~/.openclaw/openclaw.json

什么意思？

• ~ 表示你的用户主目录
• 完整路径是：/Users/你的用户名/.openclaw/openclaw.json

3.2 获取词元AI Key

第一步：访问词元AI官网获取你的 API Key

• 如果还没有账号，需要先注册
• 登录后在控制台找到 API Key，复制保存好

第二步：准备一个自定义的 token（用于本地网关认证）

• 这个 token 可以随便设置，比如：my-secret-token-123
• 记住这个 token，后面访问网关时需要用

3.3 写入配置文件

重要提示：下面的命令会创建配置文件。请按照以下步骤操作：

第一步：先创建配置目录

mkdir -p ~/.openclaw

第二步：写入配置文件（注意：需要替换两个地方）

cat > ~/.openclaw/openclaw.json <<'EOF'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "flashapi/gpt-5.2"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "flashapi": {
        "baseUrl": "https://api.ci-yuan-ai.com/v1",
        "apiKey": "你的词元AI Key",
        "api": "openai-responses",
        "models": [
          { "id": "gpt-5.2", "name": "GPT-5.2" },
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
          { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" }
        ]
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "your-token"
    }
  }
}
EOF

必须替换的地方：

1. "apiKey": "你的词元AI Key" → 把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key
2. "token": "your-token" → 把 your-token 替换成你自己设置的密码（比如 my-secret-token-123）

如何替换？

1. 复制上面整段命令
2. 把两处需要替换的地方改成你的真实信息
3. 然后粘贴到终端执行

3.4 配置说明（给想了解的人看）

默认模型设置：

• "primary": "flashapi/gpt-5.2" 表示默认使用 GPT-5.2 模型
• 如果你想默认用 Claude，改成："primary": "flashapi/claude-sonnet-4-6"
• 如果你想默认用 Gemini，改成："primary": "flashapi/gemini-2.5-pro"

可用的模型列表： 配置文件里已经添加了三个模型，你可以在使用时切换：

• gpt-5.2 - GPT-5.2（OpenAI 最新模型）
• claude-sonnet-4-6 - Claude Sonnet 4.6（Anthropic 的模型）
• gemini-2.5-pro - Gemini 2.5 Pro（Google 的模型）

重要配置项：

• "baseUrl" - 词元AI的接口地址，不要改
• "api": "openai-responses" - 使用 OpenAI 兼容格式，不要改
• "port": 18789 - 本地网关端口，和前面初始化时设置的一致

4. 重启网关并验证

配置完成后，需要重启 OpenClaw 的网关服务让配置生效。

第一步：重启网关

openclaw gateway restart

第二步：检查配置是否正确

openclaw doctor

如果看到绿色的 ✓ 标记，说明配置成功了。

第三步：查看运行状态

openclaw status

第四步：打开网页控制面板

openclaw dashboard

执行后会显示一个网址（比如 http://localhost:18789），复制这个网址到浏览器打开。

如果需要输入 token：

• 就是你在配置文件里设置的那个 token（比如 my-secret-token-123）
• 输入后就可以使用了

5. 如何切换模型？

OpenClaw 支持在使用时切换不同的 AI 模型。

方法一：在网页面板切换

1. 打开 openclaw dashboard 显示的网址
2. 在界面上找到模型选择器
3. 选择你想用的模型（GPT-5.2、Claude Sonnet 4.6 或 Gemini 2.5 Pro）

方法二：修改配置文件的默认模型

1. 用文本编辑器打开配置文件：~/.openclaw/openclaw.json
2. 找到 "primary" 这一行
3. 改成你想要的模型：
   • GPT-5.2："primary": "flashapi/gpt-5.2"
   • Claude Sonnet 4.6："primary": "flashapi/claude-sonnet-4-6"
   • Gemini 2.5 Pro："primary": "flashapi/gemini-2.5-pro"
4. 保存文件后执行 openclaw gateway restart 重启网关

常见问题

1. 提示"找不到 openclaw 命令"

原因：安装后没有重启终端，或者 Node.js 的全局包路径没有加到系统环境变量里。

解决方法：

1. 关闭终端，重新打开
2. 如果还是不行，重启电脑
3. 还不行的话，检查 Node.js 是否正确安装：node -v

2. 配置文件写入失败

原因：可能是权限问题或路径不存在。

解决方法：

1. 手动创建目录：mkdir -p ~/.openclaw
2. 然后再执行配置文件写入命令

3. 网关启动失败

原因：端口被占用，或者配置文件格式错误。

解决方法：

1. 检查配置文件是否有语法错误（特别是引号、逗号）
2. 确认 API Key 和 token 都已经正确替换
3. 尝试换一个端口号（比如改成 18790）

4. API 调用失败

原因：API Key 不正确，或者词元AI账户余额不足。

解决方法：

1. 检查 API Key 是否正确复制（注意不要有多余的空格）
2. 登录词元AI官网检查账户余额
3. 确认 baseUrl 是 https://api.ci-yuan-ai.com/v1（注意末尾的 /v1）

下一步

配置完成后，你就可以：

• 通过网页面板和 AI 对话
• 使用命令行工具调用 AI
• 在你的项目里集成 OpenClaw

更多使用方法请参考 OpenClaw 官方文档。