OpenClaw Clawdbot 自定义中转站配置教程

本文介绍如何为 OpenClaw / Clawdbot 配置自定义中转站,并完成安装、初始化、主配置、鉴权文件配置与启动检查。

第一步:安装与基础初始化

首先确保你已经安装了 Node.js 环境,然后在终端执行:

  1. 全局安装:
    npm i -g clawdbot
  2. 执行引导(根据提示完成基础设置):
    clawdbot onboard
注意:在 Windows 原生环境下,如果提示 openclaw 不是命令,请统一使用 clawdbot

第二步:修改主配置文件 clawdbot.json

打开路径:C:\Users\Administrator\.clawdbot\clawdbot.json

modelsauth 部分修改为以下内容,以支持自定义中转站。

{ "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://next.aigc2d.com/v1", "api": "openai-completions", "models": [ { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 } ] }, "api-proxy-claude": { "baseUrl": "https://next.aigc2d.com", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 } ] }, "api-proxy-google": { "baseUrl": "https://next.aigc2d.com/v1beta", "api": "google-generative-ai", "models": [ { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 } ] } } } }

第三步:配置鉴权文件 auth-profiles.json

打开路径:C:\Users\Administrator\.clawdbot\agents\main\agent\auth-profiles.json

在此处填入你从中转站获取的真实 API Key。

{ "version": 1, "profiles": { "api-proxy-gpt:default": { "type": "api_key", "provider": "api-proxy-gpt", "key": "sk-your-unique-gpt-key-here" }, "api-proxy-claude:default": { "type": "api_key", "provider": "api-proxy-claude", "key": "sk-your-unique-claude-key-here" }, "api-proxy-google:default": { "type": "api_key", "provider": "api-proxy-google", "key": "sk-your-unique-google-key-here" } }, "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 服务:
    clawdbot gateway
  3. 访问控制台:打开浏览器访问 http://127.0.0.1:18789/,使用 clawdbot onboarding 结尾输出的 Token 登录即可开始调教你的 AI Agent。