前言
很多人看到 OpenClaw 这类工具时，第一反应是“安装应该不难”，但真正卡住的往往不是安装，而是后面的模型配置、鉴权文件和连通性验证。
这篇文章把 OpenClaw 的安装、初始化、主配置文件修改、鉴权文件填写，以及最后的启动验证整理成一条完整流程。
正文
1. 先确认 Node.js 环境
开始之前，先确保本地已经安装 Node.js 18 以上版本。原始文档建议优先安装 LTS 版本，比如 20.x LTS。
如果还没安装，可以去 Node.js 官网下载安装包。安装完成后，在终端中验证：
node -v
# 输出示例：v20.11.0
npm -v
# 输出示例：10.2.4
只要版本号能正常输出，就可以继续后面的步骤。
2. 安装 OpenClaw 并完成初始化
第一步：安装 OpenClaw
在终端中执行下面两条命令：
npm install -g openclaw@latest
openclaw onboard
如果一切正常，终端会输出版本号以及初始化成功提示。
如果遇到 command not found，先检查两件事：
完成这一步后，OpenClaw 的基础骨架就搭好了。
3. 修改主配置文件 openclaw.json
接下来需要修改 OpenClaw 的主配置文件。
文件位置如下：
- Windows：C:\\Users\\你的用户名\\.openclaw\\openclaw.json
- Mac / Linux：~/.openclaw/openclaw.json
按照原始文档，把 models 和 auth 部分替换为下面的内容：
{
"agents": {
"defaults": {
"model": {
"primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
},
"models": {
"api-proxy-gpt/gpt-5.2": {
"alias": "GPT-5.2"
},
"api-proxy-claude/claude-sonnet-4-5-20250929": {
"alias": "Claude Sonnet 4.5"
},
"api-proxy-google/gemini-3-pro-preview": {
"alias": "Gemini 3 Pro"
},
"api-proxy-deepseek/deepseek-v3.2": {
"alias": "Deepseek v3.2"
}
},
"workspace": "C:\\\\Users\\\\admin\\\\clawd",
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"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"
},
"api-proxy-deepseek:default": {
"provider": "api-proxy-deepseek",
"mode": "api_key"
}
}
},
"models": {
"mode": "merge",
"providers": {
"api-proxy-gpt": {
"baseUrl": "你的 88API Base URL/v1",
"api": "openai-completions",
"models": [
{
"id": "gpt-5.2",
"name": "GPT-5.2",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
},
"api-proxy-claude": {
"baseUrl": "你的 88API Base URL",
"api": "anthropic-messages",
"models": [
{
"id": "claude-sonnet-4-5-20250929",
"name": "Claude Sonnet 4.5",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
},
"api-proxy-google": {
"baseUrl": "你的 88API Base URL/v1",
"api": "google-generative-ai",
"models": [
{
"id": "gemini-3-pro-preview",
"name": "Gemini 3 Pro",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 2000000,
"maxTokens": 8192
}
]
},
"api-proxy-deepseek": {
"baseUrl": "你的 88API Base URL/v1",
"api": "openai-completions",
"models": [
{
"id": "deepseek-v3.2",
"name": "Deepseek v3.2",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 2000000,
"maxTokens": 8192
}
]
}
}
}
}
这里有两个细节不要忽略：
4. 配置鉴权文件 auth-profiles.json
4.1 先获取 API Key
获取 API KEY
我最近用的是88api中转（https://api.88api.shop），使用中转站的好处就是不需要翻墙和注册海外账户，能够省掉很多麻烦。
1.点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
拿到 Key 后记得妥善保存，不要公开。
4.2 找到鉴权文件
文件路径如下：
- Windows：C:\\Users\\你的用户名\\.openclaw\\agents\\main\\agent\\auth-profiles.json
- Mac / Linux：~/.openclaw/agents/main/agent/auth-profiles.json
然后填入你的 API 令牌：
{
"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"
},
"api-proxy-deepseek:default": {
"type": "api_key",
"provider": "api-proxy-deepseek",
"key": "sk-your-unique-deepseek-key-here"
}
}
}
如果你当前只打算使用 Claude，那按原文说明，只填写 api-proxy-claude:default 这一项也可以，其他项可以先留空。
5. 启动并验证
5.1 启动 Gateway 服务
执行：
openclaw gateway –port 18789
如果终端输出类似下面的信息，说明服务已经正常启动：
Gateway running on http://127.0.0.1:18789
5.2 打开控制台
浏览器访问：
http://127.0.0.1:18789/
正常情况下，这里会看到 OpenClaw 的 Web 界面。
5.3 测试连通性
可以在对话框里随便输入一句，比如“你是谁”。如果 AI 能正常回复，就说明 OpenClaw 已经通过当前配置接通了模型服务。
如果报错，可以按原始文档先看这两个方向：
总结
OpenClaw 这类工具的难点，往往不在“怎么安装”，而在于模型配置、鉴权文件和启动验证是不是一次串对了。只要把 openclaw.json、auth-profiles.json 和 Gateway 启动这三段按顺序处理好，后面的使用就会顺畅很多。
如果你正好也想把多个模型统一接到一套本地工作流里，这篇配置链路基本能作为直接参考。建议实际操作时尤其注意 workspace 路径、默认模型字段和各 provider 的 Key，不然后面最容易在这些小地方反复排错。
