TokenLab 提供者設定

本指南適用於希望將 TokenLab 作為 AI 提供者連接的 自我部署（self-hosted）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
`tokenlab`	`openai-completions`	適用於 GPT、DeepSeek、Qwen 以及大多數與 OpenAI 相容的呼叫	`https://api.tokenlab.sh/v1`
`tokenlab-responses`	`openai-responses`	期望 `/v1/responses` 語意的 OpenAI Responses 工作流程	`https://api.tokenlab.sh/v1`
`tokenlab-claude`	`anthropic-messages`	原生 Claude Messages API	`https://api.tokenlab.sh`
`tokenlab-gemini`	`google-generative-ai`	原生 Gemini API 格式	`https://api.tokenlab.sh`
`tokenlab-minimax`	`anthropic-messages`	原生 MiniMax 路由	`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"
      }
    }
  }
}

模型範例

提供者	模型參考	說明
`tokenlab`	`tokenlab/gpt-4o`	OpenAI 相容路由
`tokenlab`	`tokenlab/deepseek-r1`	DeepSeek 推理模型
`tokenlab-responses`	`tokenlab-responses/gpt-4o`	Responses API 路由
`tokenlab-claude`	`tokenlab-claude/claude-sonnet-4-6`	Claude 原生 Messages 路由
`tokenlab-gemini`	`tokenlab-gemini/gemini-3.5-flash`	Gemini 原生路由
`tokenlab-minimax`	`tokenlab-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 模型。

常見錯誤

仍在使用舊的頂層 providers 陣列

目前的 OpenClaw 文件使用 models.providers。如果您保留舊的頂層 providers 陣列格式，OpenClaw 可能會忽略該設定或無法如預期解析提供者前綴。

在 tokenlab-responses 忘記加上 /v1

openai-responses 映射到 TokenLab 的 /v1/responses 路徑，因此 tokenlab-responses 必須使用 https://api.tokenlab.sh/v1。

在 tokenlab-claude、tokenlab-gemini 或 tokenlab-minimax 新增 /v1

anthropic-messages 與 google-generative-ai 應使用 https://api.tokenlab.sh（不要加 /v1）。加上 /v1 會產生不正確的請求路徑。

OpenClaw 仍然支援原生 Gemini 嗎？

支援。現行 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：

API 格式 — 了解 OpenAI、Responses、Anthropic 與 Gemini 路由之間的差異
IDE / SDK 相容性 — 了解何時使用 /v1/responses 較為適合
錯誤處理 — 學習常見失敗模式與復原策略
模型總覽 — 在將模型接入代理前先瀏覽模型 ID

相容性矩陣

程式工具

原生 SDK

框架與平台

聊天應用

TokenLab 提供者設定

建議：安裝外掛

手動提供者設定

前置需求

設定

使用模型

模型範例

何時使用哪個提供者

常見錯誤

驗證設定

下一步

​建議：安裝外掛

​手動提供者設定

​前置需求

​設定

​使用模型

​模型範例

​何時使用哪個提供者

​常見錯誤

​驗證設定

​下一步

建議：安裝外掛

手動提供者設定

前置需求

設定

使用模型

模型範例

何時使用哪個提供者

常見錯誤

驗證設定

下一步