🚀 2026最新 OpenClaw 配置教程

小白保姆级：一键接入第三方 AI大模型API中转站

告别官方昂贵且不稳定的 API！只需修改一个配置文件，让你的 OpenClaw 默认使用 Claude 4.5、GPT-4o、Deepseek 等高性价比模型。

前往简易API获取中转密钥

教程最新更新时间：

⬇️ 向下滚动查看详细教程

适用版本：2026.2.6 及之后的 OpenClaw（参考仓库 openclaw/openclaw）
配置难度：⭐（全流程只需修改一个 JSON 文件）
核心场景：你有一个“API中转站”服务，想让 OpenClaw 默认用它的模型，而不是原路直连官方。

📚 一、这篇教程会帮你做到什么？

按照本教程，你会完成：

🧐 原理图解

你（用户） ──> OpenClaw 主程序
     ├─（❌ 原路：官方 OpenAI，太贵/国内无法直连）
     └─（✅ 新路：配置简易API等第三方中转平台）
                    ↓
          Claude 4.5 / GPT-4o / Deepseek 等模型

🛠️ 二、你要提前准备的三样东西

在开始配置前，请前往你的 AI大模型API中转站 后台，准备好下面 3 个核心信息。如果你还没有中转平台，强烈推荐注册 简易API平台，国内直连，注册即送额度！

  1. API Base URL（接口地址）
    示例：https://api.jeniya.chat/v1 （⚠️ 重要：最后必须带 /v1）
  2. API Key（密钥）
    示例：sk-abc123456... （这是你的资产凭证，请妥善保管）
  3. Model ID（模型 ID）
    示例：claude-opus-4-5-20261101-thinking （必须和平台提供的一字不差）

还没有高性价比的 API Key？

立即注册简易API获取

💾 三、先备份配置（出错能秒回滚，三系统通用）

这一步绝对不能跳过！万一后面 JSON 改坏了，一行命令就能恢复。

macOS / Linux：

cd ~/.openclaw

# 备份当前配置
cp openclaw.json openclaw.json.bak

# 如果改坏了，恢复备份
cp openclaw.json.bak openclaw.json

Windows PowerShell：

cd "$env:USERPROFILE\.openclaw"

# 备份当前配置
Copy-Item openclaw.json openclaw.json.bak -Force

# 如果改坏了，恢复备份
Copy-Item openclaw.json.bak openclaw.json -Force

✍️ 四、修改核心配置（只需改 3 处）

请用 VS Code、Sublime Text 或 Cursor 编辑 openclaw.json 文件。

📍 第一处：配置 API Key（推荐写在 env，更安全）

在文件最上方，找到 "env": { ... } 这一块，如果没有就加上：

  // ... 前面是 meta, wizard 等 ...

  "env": {
    // 👇【新增这一行】名字自己起（比如 MY_API_KEY），后面填你的 sk-密钥
    "MY_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
  },

  // ...

📍 第二处：注册第三方服务商（models.providers）

在 "providers": { ... } 里面，新增你自己的中转配置，例如叫 zhongzhuan：

  "models": {
    "mode": "merge",
    "providers": {

      // 👇【从这里开始新增】===
      "zhongzhuan": {
        // 1. 【必须修改】你的中转地址，记得带 /v1
        "baseUrl": "https://api.jeniya.chat/v1",

        // 2. 引用上面 env 里设置的 Key。📍注意是 ${MY_API_KEY} 格式！
        "apiKey": "${MY_API_KEY}",

        // 3. 固定写法，表示兼容 OpenAI 协议
        "api": "openai-completions",

        // 4. 这里列出你想用的模型
        "models": [
          {
            // 【必须修改】模型 ID：和中转平台显示的一模一样
            "id": "claude-opus-4-5-20261101-thinking",
            "name": "Claude 4.5 Thinking (简易API中转)",
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            // 【可选】如果有第二个模型，可以继续加...
            "id": "claude-opus-4-6-20260203",
            "name": "Claude 4.6 (备用)",
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
      // 👆【新增结束】===

    }
  },

📍 第三处：把主路由切过去（agents.defaults）

找到 agents.defaults，把 primary 改成你的 provider名字/模型ID：

  "agents": {
    "defaults": {
      "model": {
        // 👇【修改这一行】格式是： "provider名字/模型ID"
        "primary": "zhongzhuan/claude-opus-4-5-20261101-thinking"
      },
      // ... 其他原有配置不要动 ...
    }
  }

🔄 五、重启 / 重载 OpenClaw，让配置生效

修改完配置后，需要重新加载。不同系统方式不同：

macOS（官方推荐方式）

# 强制重启网关服务
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

Linux / Windows

根据你最初的安装方式（docker、systemd、手动运行），用“先停掉旧进程 → 再重新启动”的方式重启即可。

重启后，用命令检查状态：

openclaw status --deep

如果输出里看到 default claude-opus-4-5-20261101-thinking，恭喜你配置成功了！🎉

❓ 六、常见问题（Q&A）

Q1：保存时编辑器报错（JSON Error）怎么办？

99% 是逗号问题。列表 [] 或对象 {} 的最后一项后面不能有逗号；两项之间必须有逗号。建议使用在线 JSON 校验工具检查。

Q2：为什么配置了没反应？

Q3：想换平台怎么办？

非常简单！以后你要换其他 API中转站，只需要修改 openclaw.json 里的 3 个地方：换 baseUrl、换 apiKey、换 models 里的模型 ID。强烈推荐使用稳定可靠的 简易API，一站式解决所有大模型接口需求。