OpenClaw 三方 API 配置教程（2026最新版｜5分钟完成中转接入 Claude gpt）

适用版本：OpenClaw 2026.2.6+
预计用时：5 分钟

---

🚀 懒人通道：用配置生成器一键生成 OpenClaw 配置

不想看文档？打开 OpenClaw 配置生成器，填入 3 个字段（Base URL、API Key、Model ID），自动生成可直接粘贴的 JSON 片段。

适合：第一次配置、不熟悉 JSON、想省事的用户。

下面是手动配置说明，供想了解原理或需要自定义的用户参考。

---

你需要准备的 3 样东西

从你的中转平台（本文以 v2code 为例）获取：

字段	示例
API Base URL	https://www.v2code.ai/v1（末尾必须带 /v1）
API Key	sk-abc123...
Model ID	claude-opus-4-5-20251101-thinking

---

修改配置文件

配置文件路径：

• macOS / Linux：~/.openclaw/openclaw.json
• Windows：C:\Users\<用户名>\.openclaw\openclaw.json

建议先备份：

# macOS / Linux
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

# Windows
Copy-Item "$env:USERPROFILE\.openclaw\openclaw.json" "$env:USERPROFILE\.openclaw\openclaw.json.bak" -Force

三处改动

{
  "env": {
    "V2CODE_API_KEY": "sk-你的Key"
  },

  "models": {
    "mode": "merge",
    "providers": {
      "v2code_api": {
        "baseUrl": "https://www.v2code.ai/v1",
        "apiKey": "${V2CODE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101-thinking",
            "name": "Claude 4.5 Thinking (v2code)",
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },

  "agents": {
    "defaults": {
      "model": {
        "primary": "v2code_api/claude-opus-4-5-20251101-thinking"
      },
      "models": {
        "v2code_api/claude-opus-4-5-20251101-thinking": {
          "alias": "Claude 4.5 Thinking"
        }
      }
    }
  }
}

需要替换的值：V2CODE_API_KEY、baseUrl、模型 id（三处 primary / models key 同步改）。

保存前建议校验json格式。

---

重启 OpenClaw

# macOS
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

Linux / Windows 按原启动方式重启即可。

检查状态：

openclaw status --deep

输出里能看到你配置的模型 ID 即生效。

---

测试

打开 http://127.0.0.1:18789/，新建对话发送任意消息。AI 能正常回复，且中转平台后台出现调用记录，即配置成功。

---

FAQ

• 401 / invalid api key：检查 env 的 Key 与 apiKey 引用的变量名是否一致（大小写敏感）。
• 还是走原模型：确认 agents.defaults.model.primary 已改为 平台名/模型ID，并已重启。
• 想加更多模型：在 providers.<平台>.models 数组里追加，并在 agents.defaults.models 里配 alias。
• 回退：cp openclaw.json.bak openclaw.json 后重启。