OpenClaw 安装配置教程
官方教程参考：OpenClaw 官方文档
1. 快速安装 OpenClaw（Clawdbot）
快速安装 OpenClaw（Clawdbot）
官方版（下方命令统一以官方版为准，中文社区版自行加入-cn）：
iwr -useb https://openclaw.ai/install.ps1 | iex中文社区版
iwr -useb https://clawd.org.cn/install.ps1 | iexWSL 用户注意
gateway restart。如果遇到 "Failed to connect to bus" 错误，请参考 WSL 启用 systemd 指南 或使用前台模式运行：上述命令会：更新到最新版本 → 运行诊断修复 → 重启 Gateway。
备选方式：npm 全局安装（官方版，全平台通用）
验证安装
显示版本号即安装成功；Windows 原生环境下，所有 openclaw命令需替换为clawdbot。
2. 基础初始化
请记录命令结尾输出的登录 Token（后续访问控制台需使用）。
3. 修改主配置文件（对接 api.echoflow.cn 中转站）
步骤1：定位配置文件
~/.clawdbot/clawdbot.json（~ 为用户主目录，如 /home/你的用户名）C:\Users\你的用户名\.clawdbot\clawdbot.json无此文件/目录请手动创建；Windows 需开启「显示隐藏的项目」才能看到以 .开头的文件夹。
步骤2：替换配置内容
{
"agents": {
"defaults": {
"workspace": "/home/你的用户名/clawd", // Linux/macOS/WSL 路径
// Windows 原生环境替换为："C:\\Users\\你的用户名\\clawd"
"models": {
"api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
"api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
"api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
},
"model": {
"primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
}
}
},
"auth": {
"profiles": {
"api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
"api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
"api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
}
},
"models": {
"mode": "merge",
"providers": {
"api-proxy-gpt": {
"baseUrl": "https://api.echoflow.cn/v1",
"api": "openai-completions",
"models": [
{ "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
]
},
"api-proxy-claude": {
"baseUrl": "https://api.echoflow.cn",
"api": "anthropic-messages",
"models": [
{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
]
},
"api-proxy-google": {
"baseUrl": "https://api.echoflow.cn/v1beta",
"api": "google-generative-ai",
"models": [
{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
]
}
}
}
}4. 配置鉴权文件（填入 API Key）
步骤1：定位鉴权文件
~/.clawdbot/agents/main/agent/auth-profiles.jsonC:\Users\你的用户名\.clawdbot\agents\main\agent\auth-profiles.json步骤2：填入真实 API Key
sk-xxx 为从 api.echoflow.cn 获取的对应模型令牌（需创建对应分组的令牌）：{
"version": 1,
"profiles": {
"api-proxy-gpt:default": {
"type": "api_key",
"provider": "api-proxy-gpt",
"key": "sk-your-unique-gpt-key-here"
},
"api-proxy-claude:default": {
"type": "api_key",
"provider": "api-proxy-claude",
"key": "sk-your-unique-claude-key-here"
},
"api-proxy-google:default": {
"type": "api_key",
"provider": "api-proxy-google",
"key": "sk-your-unique-google-key-here"
}
},
"lastGood": {
"api-proxy-gpt": "api-proxy-gpt:default",
"api-proxy-claude": "api-proxy-claude:default",
"api-proxy-google": "api-proxy-google:default"
}
}5. 检查并启动服务
步骤1：运行健康检查（验证配置）
无报错则配置正常；若提示 JSON 错误，核对配置文件格式（逗号、引号是否缺失）。
步骤2：启动 Gateway 服务
步骤3：访问控制台
http://127.0.0.1:18789/，使用 onboard 命令输出的 Token 登录，即可使用对接 api.echoflow.cn 的 AI 模型。总结
1.
npm i -g clawdbot，且需替换 openclaw 为 clawdbot；2.
clawdbot.json（指定中转站地址）和 auth-profiles.json（填入 API Key），需核对路径和 JSON 格式；3.
doctor 检查配置，启动后通过 http://127.0.0.1:18789/ 访问控制台。
扫码加入交流群修改于 2026-03-12 13:41:48