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

历史版本教程：以下配置面向旧 Clawdbot，目录与字段不能直接迁移到当前 OpenClaw。首次安装请使用 OpenClaw 当前配置教程。保留本页用于维护已有旧环境。

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

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

1. 全局安装：

2. 执行引导（根据提示完成基础设置）：

注意：在 Windows 原生环境下，如果提示 openclaw 不是命令，请统一使用 clawdbot 。

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

打开路径：C:\Users\你的用户名\.clawdbot\clawdbot.json 将 models 和 auth 部分修改为以下内容，以支持自定义中转站。

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\YOUR_USERNAME\\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.apizt.com/v1",
        "api": "openai-completions",
        "models": [{
          "id": "gpt-4o",
          "name": "GPT-4o",
          "contextWindow": 128000,
          "maxTokens": 8192
        }]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.apizt.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://api.apizt.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\你的用户名\.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. 运行健康检查：

2. 启动 Gateway 服务：

3. 访问控制台：打开浏览器访问 http://127.0.0.1:18789/ ，使用 clawdbot onboard 结尾输出的 Token 登录即可开始调教你的 AI Agent。

修改前后的核对

将示例中的 YOUR_USERNAME、工作目录和模型替换为当前账号与仍可用的值。主配置里的 provider ID、鉴权 profiles 中的 provider 与 agents 引用必须一致。此处模型名称与上下文数字为历史示例，不是当前模型可用性声明。迁移到新版时保留旧配置，按新版官方 schema 重新设置，而不是将整份旧 JSON 直接复制过去。