TokenLab

程式工具

TokenLab Provider 設定

將自託管的 OpenClaw 實例連接到 TokenLab

讓我的 Agent 來設定

將此任務複製給您電腦上已在執行的 Agent:

Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/zh-TW/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

本指南適用於 自託管的 OpenClaw。TokenLab 外掛程式是最快捷的設定方式;當您需要特定的 API 格式時,可以使用手動設定。

安裝外掛程式

選用:安裝已發佈的提供者外掛程式 0.1.3。透過下方描述的相同 Gateway 環境提供 TOKENLAB_API_KEY,並使用僅限工作階段的模型選擇。由於外掛程式的引導精靈會更改預設模型,因此本指南不會執行 openclaw onboard。請保留現有的外掛程式條目與權限。在發出請求前,請檢查已安裝的外掛程式與模型列表。

檢閱安裝程式要求的權限,並遵循用戶端的確認提示。請勿授予不相關的權限或更改現有外掛程式的權限。

openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab
/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

手動設定提供者

僅在 OpenClaw 需要分別使用 Responses、Claude Messages、Gemini 或 MiniMax 格式時,才使用 models.providers。對於一般的聊天,tokenlab 條目已足夠。

提供者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-messages原生 Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-ai原生 Gemini API 格式https://api.tokenlab.sh
tokenlab-minimaxanthropic-messages基於 Messages 格式的 MiniMax 模型https://api.tokenlab.sh

僅對 openai-completions 和 openai-responses 使用 /v1 後綴。

原生提供者(如 anthropic-messages 和 google-generative-ai)應使用 https://api.tokenlab.sh 而不帶 /v1,否則 OpenClaw 可能會建構出錯誤的提供者路徑。

先決條件

  • 一個自託管的 OpenClaw 實例
  • 對於 OpenClaw 2026.9.4,請使用 Node.js >=24.16.0 <25 || >=26.1.0 (版本需求)。對於其他 OpenClaw 版本,請檢查該版本的需求。
  • 一個 TokenLab API Key — 在此取得

設定

編輯您的 OpenClaw 設定檔:

  • 自託管:~/.openclaw/openclaw.json

在 models.providers 下新增 TokenLab 提供者:

使用與執行中 Gateway 相同的設定檔、OPENCLAW_STATE_DIR 和 OPENCLAW_CONFIG_PATH。在合併前請備份現有的設定檔。將 TOKENLAB_API_KEY 放入該實例受信任的全域 .env 或服務環境中;僅透過終端機匯出或專案 .env 可能無法傳遞給背景執行的 Gateway。請參閱 環境處理。

備份現有的設定檔。僅新增 TokenLab 條目,並保留現有的提供者、帳戶、預設模型選擇與權限。如果名稱已被使用,請選擇另一個名稱並更新指令。若要復原設定,只需移除您新增的條目或還原之前的備份即可。

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.6-flash", name: "Gemini 3.6 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

所有 5 個提供者都使用 相同的 API Key。您只需要一個 TokenLab 帳戶。

上述 models 陣列僅顯示常見範例。您可以根據需要為每個提供者新增更多模型 ID。

使用模型

OpenClaw 仍然使用 provider/model 格式來參照模型:

對於 OpenClaw 2026.9.4,請僅使用 -s 為當前工作階段選擇模型。請保持 agents.defaults.model、Agent 預設值與權限不變。使用 /model default -s 將此工作階段恢復為其設定的預設值。

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

模型範例

提供者模型參照說明
tokenlabtokenlab/gpt-5.6-terraOpenAI 相容 (Chat Completions)
tokenlab-responsestokenlab-responses/gpt-5.6-terraResponses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.6-flashGemini
tokenlab-minimaxtokenlab-minimax/minimax-m3基於 Messages 的 MiniMax

瀏覽所有可用模型請至 tokenlab.sh/models。

何時使用哪個提供者

  • tokenlab:大多數通用 Agent 和聊天使用案例的預設選擇。
  • tokenlab-responses:當您的 OpenClaw 工作流程明確依賴 OpenAI Responses 語義時使用。
  • tokenlab-claude:當您想要 Claude 原生 Messages 行為時使用。
  • tokenlab-gemini:當您想要 Gemini 原生請求/回應格式或現有的 Gemini 風格整合時使用。
  • tokenlab-minimax:當您想要在 Messages 格式上使用 MiniMax 模型時使用。

如果您不需要 Gemini 原生行為,您仍然可以透過 OpenAI 相容格式的 tokenlab/gemini-* 來呼叫 Gemini 模型。

常見錯誤

驗證設定

重新啟動該實例,然後檢查其選定的模型與提供者。不帶 --probe 的 models status 不會進行模型呼叫測試。即時的 --probe 或聊天訊息可能會消耗 Token。在宣告設定成功之前,請對照相應的 TokenLab 請求檢查實際的回覆。若要還原,請選擇之前的模型並僅移除您新增的 TokenLab 條目。

openclaw gateway restart
openclaw models status

在同一個 Agent 中產生圖像與影片

OpenClaw 還可以使用 TokenLab MCP server 建立圖像與短影片。每次產生都會從相同的 TokenLab 餘額中扣除費用。

openclaw mcp add tokenlab \
  --command npx \
  --arg -y \
  --arg @tokenlabai/mcp-server@0.6.48 \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlab

請保留單引號。OpenClaw 隨後會儲存該變數的參照(而非 Key 本身),並在啟動伺服器時從其執行的環境中讀取 TOKENLAB_API_KEY。Probe 會列出 TokenLab 工具。接著嘗試:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video 會回傳一個任務 ID。Agent 會呼叫 get_task_status 直到影片準備就緒。

後續步驟

一旦 OpenClaw 連接成功,這些指南將協助您更有效地使用 TokenLab:

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

本頁內容