目录

1. 前置准备（必做，避免后续报错）
2. 核心配置流程（全程实操，复制即用）
   2.1 第一步：准确定位 OpenClaw 配置文件
   2.2 第二步：添加自定义 Provider（核心步骤，决定接入成败）
   2.3 第三步：设置默认调用模型（优先使用第三方 API）
   2.4 第四步：保存配置文件
3. 配置生效与验证（关键步骤，确认接入成功）
   3.1 重启 OpenClaw 网关（确保配置加载）
   3.2 验证模型挂载状态
4. 常见问题排查（新手必看）
   【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 文件中，不同操作系统的默认路径及快速打开方式如下，务必找对文件，避免配置无效：

💡 提示：若找不到配置文件，先在终端执行 openclaw init 初始化配置，执行后会自动生成 openclaw.json 文件。

2.2 第二步：添加自定义 Provider（核心步骤，决定接入成败）

此步骤用于在 OpenClaw 中定义第三方 API，让平台能够识别并调用 Claude 模型，操作如下：

1. 用文本编辑器打开找到的 openclaw.json 文件；
2. 找到models.providers 节点（若文件中没有该节点，直接新增该层级）；
3. 复制以下完整 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", # 替换为自己申请的第三方API Key
        "api": "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 模型，避免路由到官方接口，操作如下：

1. 在 openclaw.json 中找到 agents.defaults 节点；
2. 新增或修改 model.primary 字段，格式为「Provider 名称/模型 ID」，必须与第二步配置完全一致（示例："primary": "custom-ai-nengyongai-cn/claude-3-7-sonnet-latest"）。

2.4 第四步：保存配置文件

完成以上所有修改后，按 Ctrl+S（Windows）或 Cmd+S（macOS）保存文件，此时配置已初步生效，进入下一步验证环节。

3. 配置生效与验证（关键步骤，确认接入成功）

3.1 重启 OpenClaw 网关（确保配置加载）

OpenClaw 支持热重载，但模型配置修改后，必须重启网关才能完全生效，执行以下命令（终端输入）：

1. 停止当前网关服务：openclaw gateway stop
2. 重新启动网关：openclaw gateway --port 18789

3.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 全系列模型，适配各类开发场景。