🎁 邀请返现
各种插件/软件使用教程 / 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.timrouter.com/v1",
        "api": "openai-completions",
        "models": [{
          "id": "gpt-4o",
          "name": "GPT-4o",
          "contextWindow": 128000,
          "maxTokens": 8192
        }]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.timrouter.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.timrouter.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
  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 自定义 TimRouter”进入本页，建议先行核查 API Key、Base URL 和模型 ID。绝大多数发起调用异常均源于这三项配置。

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

常见排查方向

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

相关入口

常见问题

OpenClaw Clawdbot 自定义 能够借助 TimRouter API 接入大模型吗？

可以。只要 OpenClaw Clawdbot 自定义 全面支持自定义 API Key、Base URL 或兼容 OpenAI 与 Claude 协议的端点，就可以按本页方式接入 TimRouter。

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

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

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

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

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