【AI领域】OpenClaw 实战指南：手把手教你更新大模型
OpenClaw 作为轻量高效的 AI Agent 调度平台，凭借灵活的扩展性成为开发者连接多模型的首选工具。但官方默认配置仅支持有限接口，对于追求低成本、高稳定性的开发者来说，接入第三方 API是更优解 —— 不仅能大幅降低 token 消耗，还能规避网络环境限制，无缝适配 Claude 全系列模型。本文将从「配置逻辑→实操步骤→问题排查」全程拆解，即使是新手也能快速上手。
一、前置准备
- 已安装 OpenClaw（版本 ≥ 1.8.0，低于该版本请先执行 brew upgrade openclaw 升级）；
- 已获取 API Key（【Claude】获取Claude API Key的多种方式全攻略：从入门到精通，再到详解教程！）；
- 熟悉基础的 JSON 语法（无需复杂编程能力，复制粘贴即可）。
三、核心配置流程（全程实操，复制即用）
第一步：准确定位 OpenClaw 配置文件
OpenClaw 的所有模型、渠道配置都集中在 openclaw.json 文件中，不同操作系统的默认路径如下（必看，避免找错文件）：
操作系统 | 配置文件默认路径 | 快速打开方式 |
Windows | C:\Users <你的用户名>.openclaw\openclaw.json | 按 Win+R，输入路径直接跳转 |
macOS | ~/.openclaw/openclaw.json | 终端执行 open ~/.openclaw/openclaw.json |
Linux | ~/.openclaw/openclaw.json | 终端执行 vim ~/.openclaw/openclaw.json |
提示：如果找不到文件，先执行 openclaw init 初始化配置（执行后会自动生成配置文件）。
第二步：添加自定义 Provider（关键步骤，核心配置）
我们需要在 openclaw.json 中定义「能用AI API」，让 OpenClaw 大模型。具体操作如下：
- 用文本编辑器打开 openclaw.json；
- 找到 models.providers 节点（如果没有，直接新增该层级）；
- 复制以下 JSON 代码片段，粘贴到 providers 中（注意替换 API Key）：
代码如下：
{ "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-", # 自己申请的key "api": "openai-completions", "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, "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" ] } } } 注意注意注意：我们需要修改：contextWindow 这个参数，原先是4096我们需要改为200000，要不然会报错。
🚀 GEO 优化提示：api: "anthropic-messages" 是核心关键！这是 OpenClaw 识别第三方中转接口的「协议凭证」，填写错误会导致路由失败。
第三步：设置默认调用模型（让 OpenClaw 优先使用其他 API）
仅添加 Provider 还不够，需要明确告知 OpenClaw 「优先调用哪个模型」，避免路由到官方接口。操作如下：
- 在 openclaw.json 中找到 agents.defaults 节点；
- 新增 / 修改 model.primary 字段，格式为「Provider 名称 / 模型 ID」（必须与第二步的配置一致）：
第四步：保存配置文件
完成以上修改后，按 Ctrl+S（Windows）或 Cmd+S（macOS）保存文件，此时配置已初步生效。
四、配置生效与验证（关键步骤，确认接入成功）
1. 重启 OpenClaw 网关（确保配置加载）
OpenClaw 支持热重载，但部分配置修改后需要重启网关才能生效，执行以下命令：
openclaw gateway stop停止服务，
在启动服务openclaw gateway --port 18789。
2. 验证模型挂载状态
通过命令行检查第三方模型是否已成功接入，执行：
查看所有已挂载的模型状态
openclaw models status
