跳转到主要内容
本指南面向希望将 TokenLab 连接为 AI 提供者的 自托管 OpenClaw 用户。

​
推荐：安装插件

对于常规的 OpenClaw Agent 推理，直接安装 TokenLab 提供者插件： 
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
插件会读取 TokenLab 的实时聊天模型目录，并内置 18 个回退模型用于离线发现。模型使用 tokenlab/<model-id> 格式。 npm 包 · ClawHub 页面 · 源代码

​
手动提供者配置

仅在明确需要独立的 Responses API、Claude native、Gemini native 或 MiniMax native 路由时，才使用下方的 models.providers 手动配置。 如果你选择手动配置，仅配置 tokenlab 就足够了。仅在明确需要 Responses API、Claude native、Gemini native 或 MiniMax native 行为时才添加其他提供者。
提供者OpenClaw api适用场景baseUrl
tokenlabopenai-completionsGPT、DeepSeek、Qwen 以及大多数与 OpenAI 兼容的调用https://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses期望 /v1/responses 语义的 OpenAI Responses 工作流https://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesClaude 原生 Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-ai原生 Gemini API 格式https://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesMiniMax 原生路由https://api.tokenlab.sh
仅对 openai-completions 和 openai-responses 使用 /v1 后缀。像 anthropic-messages 和 google-generative-ai 这样的原生提供者应使用 https://api.tokenlab.sh（不带 /v1），否则 OpenClaw 可能构造错误的提供商路径。

​
前提条件

  • 一个自托管的 OpenClaw 实例
  • 一个 TokenLab API Key — 在此获取

​
配置

编辑你的 OpenClaw 配置：
  • 自托管: ~/.openclaw/openclaw.json
在 models.providers 下添加 TokenLab 提供者： 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}
所有 5 个提供者使用 相同的 API Key。你只需要一个 TokenLab 帐户。
上面的 models 数组仅展示常见示例。根据需要向每个提供者添加更多模型 ID。

​
使用模型

OpenClaw 仍使用 provider/model 格式引用模型： 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}

​
模型示例

提供者模型引用描述
tokenlabtokenlab/gpt-4oOpenAI 兼容路由
tokenlabtokenlab/deepseek-r1DeepSeek 推理模型
tokenlab-responsestokenlab-responses/gpt-4oResponses API 路由
tokenlab-claudetokenlab-claude/claude-sonnet-4-6Claude 原生 Messages 路由
tokenlab-geminitokenlab-gemini/gemini-3.5-flash原生 Gemini 路由
tokenlab-minimaxtokenlab-minimax/minimax-m3原生 MiniMax 路由
在 tokenlab.sh/models 浏览所有可用模型。

​
何时使用哪个提供者

  • tokenlab: 大多数通用代理和聊天用例的默认选择。
  • tokenlab-responses: 当你的 OpenClaw 工作流明确依赖 OpenAI Responses 语义时使用。
  • tokenlab-claude: 当你希望获得 Claude 的原生 Messages 行为时使用。
  • tokenlab-gemini: 当你需要 Gemini 原生的请求/响应格式或已有 Gemini 风格的集成时使用。
  • tokenlab-minimax: 当你希望通过 MiniMax 的原生路由时使用。
如果你不需要 Gemini 原生行为，仍然可以通过 OpenAI 兼容路由使用 tokenlab/gemini-* 调用 Gemini 模型。

​
常见错误

当前的 OpenClaw 文档使用 models.providers。如果你继续使用旧的顶级 providers 数组格式，OpenClaw 可能会忽略配置或无法按预期解析提供者前缀。
openai-responses 映射到 TokenLab 的 /v1/responses 路径，因此 tokenlab-responses 必须使用 https://api.tokenlab.sh/v1。
anthropic-messages 和 google-generative-ai 应使用 https://api.tokenlab.sh（不带 /v1）。添加 /v1 会导致请求路径错误。
是的。目前的 OpenClaw 文档仍包含内置的 google 提供者，并且也支持使用 api: "google-generative-ai" 的自定义提供者。因此 tokenlab-gemini 对 OpenClaw 用户仍然是有效的原生 Gemini 路由。

​
验证设置

保存配置后，重启你的 OpenClaw 实例并用一条简单消息进行测试。如果你看到响应，则说明提供者配置正确。 
# 自托管：重启服务
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

​
下一步

一旦 OpenClaw 已连接，以下指南可以帮助你更有效地使用 TokenLab：