TokenLab 提供者設定

在 OpenClaw 中將 TokenLab 設為自訂提供者，透過 OpenAI、Responses、Anthropic 與 Gemini 相容路由進行配置

交給我的 Agent 設定

把這段任務交給電腦上已經可用的 Agent：

閱讀此教學，協助我將 OpenClaw 連接至 TokenLab：
https://tokenlab.sh/docs/zh-TW/guides/tokenlab-provider
先檢查已安裝版本與目前生效的設定。
保留既有帳戶、供應商、權限及其他設定。
備份本機檔案並展示預計修改的內容。
讓我在本機輸入所需的 API 金鑰；不要在聊天中索取、顯示或貼上金鑰。
先確認設定能正常載入。
執行任何付費請求測試前，請另行說明費用。

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

建議：安裝外掛

選用：安裝已發布的供應商外掛 0.1.0，透過下文所述的相同 Gateway 環境提供 TOKENLAB_API_KEY，並只為工作階段選擇模型。外掛的入門精靈會改變預設模型，因此本指南不執行 openclaw onboard。保留原外掛項目與權限，在傳送請求前檢查外掛載入與模型清單。

檢查安裝程式要求的能力，並依用戶端提示確認。不要授予無關權限或改變既有外掛的權限。

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab

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

npm · GitHub

手動提供者設定

僅在明確需要獨立的 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 實例
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 對應的 profile、OPENCLAW_STATE_DIR 與 OPENCLAW_CONFIG_PATH，合併前備份實際設定。將 TOKENLAB_API_KEY 放入該實例可信的全域 .env 或服務環境；終端 export 或專案 .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-reasoner", name: "DeepSeek Reasoner" },
          { 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.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: "${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

模型範例

提供者	模型參考	說明
`tokenlab`	`tokenlab/gpt-5.6-terra`	OpenAI 相容路由
`tokenlab-responses`	`tokenlab-responses/gpt-5.6-terra`	Responses API 路由
`tokenlab-claude`	`tokenlab-claude/claude-sonnet-5`	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 模型。

常見錯誤

驗證設定

重新啟動同一實例後檢查模型與供應商。不帶 --probe 的 models status 不是模型測試；真實探測或對話可能消耗 token。請核對回覆與 TokenLab 請求記錄。還原時選回原模型，僅移除本次加入的項目。

openclaw gateway restart
openclaw models status

下一步

一旦 OpenClaw 已連線，以下指南可協助您更有效地使用 TokenLab：

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

TokenLab 提供者設定

交給我的 Agent 設定Copy Anchor Link

建議：安裝外掛Copy Anchor Link

手動提供者設定Copy Anchor Link

前置需求Copy Anchor Link

設定Copy Anchor Link

使用模型Copy Anchor Link

模型範例Copy Anchor Link

何時使用哪個提供者Copy Anchor Link

常見錯誤Copy Anchor Link

仍在使用舊的頂層 providers 陣列

在 tokenlab-responses 忘記加上 /v1

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

OpenClaw 仍然支援原生 Gemini 嗎？

驗證設定Copy Anchor Link

下一步Copy Anchor Link

本頁內容