跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

本指南適用於希望將 TokenLab 作為 AI 提供者連接的 自我部署（self-hosted）OpenClaw 使用者。

​
概覽

對於目前的 OpenClaw 版本，建議的做法是透過 models.providers 來配置 TokenLab。 如果您只是想快速開始，僅設定 tokenlab 即足夠。僅在您明確需要 Responses API、Claude native、Gemini native 或 MiniMax native 行為時才新增其他提供者。
提供者OpenClaw api適用於baseUrl
tokenlabopenai-completions適用於 GPT、DeepSeek、Qwen 以及大多數與 OpenAI 相容的呼叫https://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses期望 /v1/responses 語意的 OpenAI Responses 工作流程https://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messages原生 Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-ai原生 Gemini API 格式https://api.tokenlab.sh
tokenlab-minimaxanthropic-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-32b", name: "Qwen 3 32B" }
        ]
      },
      "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-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
所有 5 個提供者使用相同的 API Key。您只需要一個 TokenLab 帳戶。
上面 models 陣列僅顯示常見範例。視需要為每個提供者新增更多模型 ID。

​
使用模型

OpenClaw 仍以 provider/model 格式來參考模型： 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-2.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-2.5-flashGemini 原生路由
tokenlab-minimaxtokenlab-minimax/minimax-m1MiniMax 原生路由
在 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：
  • API 格式 — 了解 OpenAI、Responses、Anthropic 與 Gemini 路由之間的差異
  • IDE / SDK 相容性 — 了解何時使用 /v1/responses 較為適合
  • 錯誤處理 — 學習常見失敗模式與復原策略
  • 模型總覽 — 在將模型接入代理前先瀏覽模型 ID