你是不是也遇到过这些问题官方 API 偶发不稳定任务跑到一半中断想切换模型时要反复改配置、改 Key明明照着文档配了结果还是 400/401 报错如果你正在本地用 OpenClaw 做 AI 编程或多模型对比这篇就是给你的。 我会用一套可复用的配置流程带你把GPT、Claude、Gemini、DeepSeek统一接入到同一个 OpenClaw 工作流里。目标很明确一次配置、稳定调用、随时切换模型。一、开始前3 分钟准备清单先确认这 4 件事后面基本不会卡壳已安装Node.js v18有终端权限Windows: PowerShell/CMDmacOS: Terminal本机有空闲端口示例用18789已准备好中转站 API Key先执行node -v npm -v如果能正常输出版本号就可以继续。二、安装 OpenClaw 并初始化1全局安装npm install -g openclawlatest2执行初始化引导openclaw onboard执行后会在用户目录生成.openclaw文件夹这是后续所有配置的根目录。常见路径WindowsC:\\Users\\你的用户名\\.openclawmacOS~/.openclaw隐藏目录可用ls -a ~查看三、核心配置openclaw.json决定模型能不能正常跑这是最关键的一步。 文件路径WindowsC:\\Users\\admin\\.openclaw\\openclaw.jsonmacOS~/.openclaw/openclaw.json1先备份原配置强烈建议# macOS/Linux cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bakWindows 可以手动复制一份改名为openclaw.json.bak。2完整配置示例四模型版primary改成你最常用的模型即可。 若解析报错请去掉 JSON 内注释部分环境不支持注释。{ 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: https://api.88api.chat/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: https://api.88api.chat, 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: https://api.88api.chat/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: https://api.88api.chat/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 } ] } } } }3三大高频坑90% 报错都在这协议类型写错Claude 必须anthropic-messagesGemini 必须google-generative-aiGPT/DeepSeek 常用openai-completionsbaseUrl 路径不一致Claude 这里通常不带/v1其他 Provider 常见是/v1Windows 路径转义错误workspace里反斜杠要写成\\\\四、鉴权配置auth-profiles.json填真实 Keyopenclaw.json只声明鉴权方式真正密钥写在这里WindowsC:\\Users\\admin\\.openclaw\\agents\\main\\agent\\auth-profiles.jsonmacOS~/.openclaw/agents/main/agent/auth-profiles.json{ 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 } } }如果你想要一个统一入口来管理多模型 Key像 88API 这种多模型聚合服务会省掉不少重复配置成本。五、启动并验证确保真能用1启动 Gatewayopenclaw gateway --port 187892浏览器访问打开http://127.0.0.1:18789/3按这个清单检查是否能看到 4 个模型GPT / Claude / Gemini / DeepSeek切换模型后测试消息是否都能返回日志里请求地址是否走中转站而不是官方直连六、常见问题排查建议按顺序查Q1看不到自定义模型检查models.mode是否是merge检查providers名称和auth.profiles的 provider 是否一致检查 JSON 是否有语法错误尤其逗号和注释Q2Claude 返回 400api是否写成anthropic-messagesbaseUrl是否错误加了/v1Q3返回 401 UnauthorizedKey 填错 / 过期Key 没有对应模型权限auth-profiles.json保存路径不对最常见Q4macOS 找不到.openclawFinder 按Command Shift .显示隐藏文件或终端执行ls -a ~七、安全与协作建议别把密钥泄露了永远不要提交密钥文件到 Git.gitignore建议加上.openclaw/agents/团队协作时只共享openclaw.json模板不共享真实auth-profiles.json建议每季度轮换一次 Key降低泄露风险结语到这里你已经完成了一套可复用的多模型接入方案OpenClaw 内统一调度 GPT、Claude、Gemini、DeepSeek按任务场景自由切换。这套方式的价值不只是“能跑通”更是把后续维护成本降下来。 尤其当你要做多模型 A/B 测试、Prompt 对比或稳定性验证时一套统一网关会明显省时。