macOS / Linux OpenClaw(原名Clawdbot)安装指南
在 macOS 或 Linux 系统上安装 OpenClaw(原名Clawdbot),并配置为使用积木AI代码助手接口。
系统要求
系统
macOS 10.15+ 或主流 Linux 发行版(Ubuntu 18.04+、Debian 10+等)
依赖
Node.js 16+
Node.js 安装(如果没有安装)
macOS:前往 nodejs.org/zh-cn/download 下载
Linux(Debian/Ubuntu):
Linux(Debian/Ubuntu):
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -,然后 sudo apt-get install -y nodejs
安装步骤
1
打开终端
macOS 可用 Cmd+Space 搜索 Terminal,或使用 VS Code / JetBrains 的内置终端打开;Linux 打开你常用的终端即可。
2
安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
3
创建并复制 API Key
登录后到「API Key」页面分别创建 Codex / Claude / Gemini 三条产品线的 Key(各复制一份)。
4
脚本快速配置(推荐)
curl -fsSL https://code.jimuxyz.com/env_deploy/openclaw-deploy.sh | bash -s -- "你的Codex_API_KEY" "你的Claude_API_KEY" "你的Gemini_API_KEY"
脚本会写入 ~/.openclaw/openclaw.json 并备份旧文件。参数顺序:Codex / Claude / Gemini。
脚本失败排障:
- 提示下载失败:检查网络/代理或稍后重试。
- 提示 API Key 为空:确认已把 Codex / Claude / Gemini 三个 Key 都替换为真实值。
- 写入后不生效:关闭并重新启动 OpenClaw。
或者
跳到下方「手动配置」,按手动方式替换 JSON 内容。
手动配置
打开 ~/.openclaw/openclaw.json,将 models 部分替换为以下内容,并把各产品线 apiKey 改成自己的 Key。
{
"models": {
"providers": {
"jimuxyz-claude": {
"baseUrl": "https://code.jimuxyz.com/p",
"apiKey": "你的Claude_API_KEY",
"api": "anthropic-messages",
"models": [
{
"id": "claude-haiku-4-5",
"name": "Claude Haiku 4.5"
},
{
"id": "claude-sonnet-4-5",
"name": "Claude Sonnet 4.5"
},
{
"id": "claude-opus-4-5",
"name": "Claude Opus 4.5"
},
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6"
}
]
},
"jimuxyz-codex": {
"baseUrl": "https://code.jimuxyz.com/p",
"apiKey": "你的Codex_API_KEY",
"api": "openai-responses",
"models": [
{
"id": "gpt-5.1-codex-mini",
"name": "GPT-5.1 Codex Mini"
},
{
"id": "gpt-5.1-codex-max",
"name": "GPT-5.1 Codex Max"
},
{
"id": "gpt-5.3-codex",
"name": "GPT-5.3 Codex"
}
]
},
"jimuxyz-gemini": {
"baseUrl": "https://code.jimuxyz.com/p",
"apiKey": "你的Gemini_API_KEY",
"models": [
{
"id": "gemini-2.5-pro",
"name": "Gemini 2.5 Pro"
},
{
"id": "gemini-2.5-flash",
"name": "Gemini 2.5 Flash"
},
{
"id": "gemini-2.5-flash-lite",
"name": "Gemini 2.5 Flash Lite"
}
]
}
}
}
}