新手友好｜OpenClaw 接入 Claude 第三方 API 步骤详解

目录前置准备必做避免后续报错核心配置流程全程实操复制即用2.1 第一步准确定位 OpenClaw 配置文件2.2 第二步添加自定义 Provider核心步骤决定接入成败2.3 第三步设置默认调用模型优先使用第三方 API2.4 第四步保存配置文件配置生效与验证关键步骤确认接入成功3.1 重启 OpenClaw 网关确保配置加载3.2 验证模型挂载状态常见问题排查新手必看【OpenAI】获取OpenAI API Key的多种方式全攻略从入门到精通再到详解教程OpenClaw 作为轻量高效的 AI Agent 调度平台凭借极强的扩展性成为开发者连接多模型的首选工具。但其官方默认配置仅支持有限接口对于追求低成本、高稳定性的开发者而言接入第三方 API 是更优解——不仅能大幅降低 Token 消耗还能规避网络环境限制无缝适配 Claude 全系列模型。本文将从「配置逻辑→实操步骤→问题排查」全程拆解步骤清晰、代码可直接复制即使是新手也能快速上手轻松完成第三方 Claude API 接入。1. 前置准备必做避免后续报错已安装 OpenClaw版本 ≥ 1.8.0低于该版本请先执行命令升级brew upgrade openclaw已获取第三方 API Key参考【Claude】API Key 获取全攻略从入门到精通熟悉基础 JSON 语法无需复杂编程能力全程复制粘贴即可完成配置。2. 核心配置流程全程实操复制即用2.1 第一步准确定位 OpenClaw 配置文件OpenClaw 的所有模型、渠道配置均集中在openclaw.json文件中不同操作系统的默认路径及快速打开方式如下务必找对文件避免配置无效操作系统配置文件默认路径快速打开方式WindowsC:\Users你的用户名.openclaw\openclaw.json按 WinR粘贴路径直接跳转macOS~/.openclaw/openclaw.json终端执行open ~/.openclaw/openclaw.jsonLinux~/.openclaw/openclaw.json终端执行vim ~/.openclaw/openclaw.json 提示若找不到配置文件先在终端执行openclaw init初始化配置执行后会自动生成openclaw.json文件。2.2 第二步添加自定义 Provider核心步骤决定接入成败此步骤用于在 OpenClaw 中定义第三方 API让平台能够识别并调用 Claude 模型操作如下用文本编辑器打开找到的openclaw.json文件找到models.providers节点若文件中没有该节点直接新增该层级复制以下完整 JSON 代码片段粘贴到providers节点中务必替换其中的 API Key将sk-替换为自己申请的密钥。{meta:{lastTouchedVersion:2026.2.26,lastTouchedAt:2026-02-28T12:23:56.399Z},wizard:{lastRunAt:2026-02-28T12:23:56.381Z,lastRunVersion:2026.2.26,lastRunCommand:onboard,lastRunMode:local},models:{mode:merge,providers:{custom-ai-nengyongai-cn:{baseUrl:https://ai.nengyongai.cn/v1,apiKey:sk-xxxxxxx,# 替换为自己申请的第三方APIKeyapi:anthropic-messages,# 核心关键不可修改否则路由失败models:[{id:claude-3-7-sonnet-latest,name:claude-3-7-sonnet-latest (Custom Provider),reasoning:false,input:[text],cost:{input:0,output:0,cacheRead:0,cacheWrite:0},contextWindow:200000,# 必改默认4096不改会报错maxTokens:4096}]}}},agents:{defaults:{model:{primary:custom-ai-nengyongai-cn/claude-3-7-sonnet-latest},models:{custom-ai-nengyongai-cn/claude-3-7-sonnet-latest:{alias:claude-3.7-sonnet}},workspace:/Users/sd/.openclaw/workspace,compaction:{mode:safeguard},maxConcurrent:4,subagents:{maxConcurrent:8}}},messages:{ackReactionScope:group-mentions},commands:{native:auto,nativeSkills:auto,restart:true,ownerDisplay:raw},session:{dmScope:per-channel-peer},gateway:{port:18789,mode:local,bind:loopback,auth:{mode:token,token:ec42ee176abcc18a943718bcd9f80d7635765571b2ab50d5},tailscale:{mode:off,resetOnExit:false},nodes:{denyCommands:[camera.snap,camera.clip,screen.record,calendar.add,contacts.add,reminders.add]}}} GEO 优化关键提示api: anthropic-messages是核心协议凭证OpenClaw 通过该字段识别第三方中转接口填写错误会直接导致路由失败务必保持不变 必改提醒contextWindow参数必须改为 200000默认 4096 会导致配置报错无法正常调用模型。2.3 第三步设置默认调用模型优先使用第三方 API仅添加 Provider 还不够需明确告知 OpenClaw 优先调用第三方 Claude 模型避免路由到官方接口操作如下在openclaw.json中找到agents.defaults节点新增或修改model.primary字段格式为「Provider 名称/模型 ID」必须与第二步配置完全一致示例primary: custom-ai-nengyongai-cn/claude-3-7-sonnet-latest。2.4 第四步保存配置文件完成以上所有修改后按 CtrlSWindows或 CmdSmacOS保存文件此时配置已初步生效进入下一步验证环节。3. 配置生效与验证关键步骤确认接入成功3.1 重启 OpenClaw 网关确保配置加载OpenClaw 支持热重载但模型配置修改后必须重启网关才能完全生效执行以下命令终端输入停止当前网关服务openclaw gateway stop重新启动网关openclaw gateway --port 187893.2 验证模型挂载状态通过命令行检查第三方 Claude 模型是否已成功接入执行以下命令查看所有已挂载的模型状态openclaw models status✅ 验证成功标志终端输出中能看到custom-ai-nengyongai-cn/claude-3-7-sonnet-latest且状态为「可用」说明第三方 API 已成功接入。4. 常见问题排查新手必看配置后报错「contextWindow 异常」检查contextWindow参数是否改为 200000未修改会导致模型调用失败模型挂载失败、路由异常检查api: anthropic-messages是否填写正确或 Provider 名称、模型 ID 与model.primary字段是否一致找不到配置文件执行openclaw init重新初始化即可生成配置文件网关启动失败检查端口 18789 是否被占用可更换端口将命令中的 18789 改为其他未占用端口如 18790。按照以上步骤操作即可快速完成 OpenClaw 第三方 Claude API 接入低成本、高稳定地调用 Claude 全系列模型适配各类开发场景。