注册
各种插件/软件使用教程 / OpenClaw Clawdbot 自定义中转站配置教程

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

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

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

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

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

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

{
  "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.quickrouter.ai/v1",
        "api": "openai-completions",
        "models": [{
          "id": "gpt-4o",
          "name": "GPT-4o",
          "contextWindow": 128000,
          "maxTokens": 8192
        }]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.quickrouter.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.quickrouter.ai/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
  1. 启动 Gateway 服务：
clawdbot gateway
  1. 访问控制台：打开浏览器访问 http://127.0.0.1:18789/ ，使用 clawdbot onboarding 结尾输出的 Token 登录即可开始调教你的 AI Agent。

OpenClaw Clawdbot 自定义 API 中转配置要点

如果你通过搜索“OpenClaw Clawdbot 自定义 配置教程”“OpenClaw Clawdbot 自定义 API 中转”“OpenClaw Clawdbot 自定义 QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。

配置项填写建议常见问题
API Key填写 QuickRouter 控制台创建的密钥401 通常是 Key 错误、过期或额度不足
Base URL按本页工具要求填写 QuickRouter 接口地址；OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1Claude/Anthropic 类工具不一定带 /v1
模型 ID从价格页复制完整模型名model not found 通常是模型名或分组权限问题

常见排查方向

  • 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
  • 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
  • 连接超时：确认工具里的 Base URL 没有多写路径或空格。
  • Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。

相关入口

常见问题

OpenClaw Clawdbot 自定义 可以通过 QuickRouter API 接入大模型吗？

可以。只要 OpenClaw Clawdbot 自定义 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。

OpenClaw Clawdbot 自定义 的 Base URL 应该怎么填？

按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。

OpenClaw Clawdbot 自定义 提示 model not found 怎么办？

到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。

← OpenClaw配合CC switch自定义中转站配置教程 GPT-4o-audio →