🚀 OpenClaw / Clawdbot 接入 CodingPlanX 自定义模型

本教程将引导你完成 Clawdbot (OpenClaw) 的安装及自定义 API 中转站（Proxy）的配置，让你能够灵活调用 GPT-4o、Claude 3.5 及 Gemini 等模型。

🛠️ 第一步：环境准备与基础初始化

在开始之前，请确保你的系统中已安装 Node.js 环境。

1. 全局安装 Clawdbot

打开终端（CMD 或 PowerShell），执行以下命令：

npm i -g clawdbot

2. 执行初始化引导

执行引导程序以完成基础设置。请根据屏幕提示进行操作：

clawdbot onboard

> [!IMPORTANT] > Windows 用户注意： 在原生环境下，如果系统提示 openclaw 不是内部命令，请务必统一使用 clawdbot 命令。

⚙️ 第二步：修改主配置文件 `clawdbot.json`

此步骤通过修改主配置文件，定义中转站的 API 地址及模型映射关系。

文件路径： C:\Users\你的用户名\.clawdbot\clawdbot.json (注：原教程路径为 Administrator，请根据实际用户名修改)

将文件中的 agents、auth 和 models 部分参考以下内容进行修改：

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

🔑 第三步：配置鉴权文件 `auth-profiles.json`

在此步骤中，你需要填入从中转站获取的真实 API Key。

文件路径： C:\Users\你的用户名\.clawdbot\agents\main\agent\auth-profiles.json

请修改 key 字段为你自己的 API 密钥：

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-你的真实GPT密钥"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-你的真实Claude密钥"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-你的真实Google密钥"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

🚦 第四步：检查并启动服务

配置完成后，通过以下流程验证并运行。

1. 运行健康检查

检查配置语法和连通性是否正常：

clawdbot doctor

2. 启动 Gateway 服务

运行网关服务以开启 AI 代理：

clawdbot gateway

3. 访问 Web 控制台

打开浏览器，访问：http://127.0.0.1:18789/
登录凭证： 使用第一步执行 clawdbot onboard 结尾处输出的 Token 进行登录。
现在，你可以开始调教并使用你的 AI Agent 了！

💡 提示： 如果更换了中转站供应商，只需在 clawdbot.json 中修改对应的 baseUrl 并在 auth-profiles.json 中更新 key 即可。