> ## 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 提供者設定

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

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

## 建議：安裝外掛

對於一般的 OpenClaw Agent 推論，請直接安裝 TokenLab 提供者外掛：

```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```

外掛會讀取 TokenLab 的即時聊天模型目錄，並內建 18 個備援模型供離線探索。模型使用 `tokenlab/<model-id>` 格式。

[npm 套件](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [ClawHub 頁面](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [原始碼](https://github.com/hedging8563/tokenlab-openclaw-provider)

## 手動提供者設定

僅在明確需要獨立的 **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`    |

<Warning>
  僅對 `openai-completions` 與 `openai-responses` 使用 `/v1` 後綴。

  像 `anthropic-messages` 與 `google-generative-ai` 這類原生提供者應使用 `https://api.tokenlab.sh`（不要加 `/v1`），否則 OpenClaw 可能會組成錯誤的供應商路徑。
</Warning>

## 前置需求

* 一個自我部署的 OpenClaw 實例
* 一個 TokenLab API Key — [在這裡取得](https://tokenlab.sh/dashboard)

## 設定

編輯您的 OpenClaw 設定檔：

* **自我部署**: `~/.openclaw/openclaw.json`

在 `models.providers` 下新增 TokenLab 提供者：

```json5 theme={null}
{
  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" }
        ]
      }
    }
  }
}
```

<Info>
  所有 5 個提供者使用相同的 **API Key**。您只需要一個 TokenLab 帳戶。
</Info>

<Info>
  上面 `models` 陣列僅顯示常見範例。視需要為每個提供者新增更多模型 ID。
</Info>

## 使用模型

OpenClaw 仍以 `provider/model` 格式來參考模型：

```json5 theme={null}
{
  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](https://tokenlab.sh/zh-TW/models) 瀏覽所有可用模型。

## 何時使用哪個提供者

* `tokenlab`: 大多數通用代理與聊天使用情境的預設選擇。
* `tokenlab-responses`: 當您的 OpenClaw 工作流程明確依賴 OpenAI Responses 語意時使用。
* `tokenlab-claude`: 當您想要 Claude 的原生 Messages 行為時使用。
* `tokenlab-gemini`: 當您需要 Gemini 原生的請求/回應格式或已有 Gemini 風格的整合時使用。
* `tokenlab-minimax`: 當您想要透過 MiniMax 的原生路由時使用。

如果您不需要 Gemini 原生行為，仍然可以透過 OpenAI 相容路由使用 `tokenlab/gemini-*` 呼叫 Gemini 模型。

## 常見錯誤

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

  <Accordion title="在 tokenlab-responses 忘記加上 /v1">
    `openai-responses` 映射到 TokenLab 的 `/v1/responses` 路徑，因此 `tokenlab-responses` 必須使用 `https://api.tokenlab.sh/v1`。
  </Accordion>

  <Accordion title="在 tokenlab-claude、tokenlab-gemini 或 tokenlab-minimax 新增 /v1">
    `anthropic-messages` 與 `google-generative-ai` 應使用 `https://api.tokenlab.sh`（不要加 `/v1`）。加上 `/v1` 會產生不正確的請求路徑。
  </Accordion>

  <Accordion title="OpenClaw 仍然支援原生 Gemini 嗎？">
    支援。現行 OpenClaw 文件仍包含內建的 `google` 提供者，並且也支援使用 `api: "google-generative-ai"` 的自訂提供者。因此 `tokenlab-gemini` 對於 OpenClaw 使用者來說仍然是有效的原生 Gemini 路由。
  </Accordion>
</AccordionGroup>

## 驗證設定

儲存設定後，重新啟動您的 OpenClaw 實例並用簡單訊息測試。如果您看到回應，表示提供者已正確配置。

```bash theme={null}
# 自託管：重新啟動服務
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS
```

## 下一步

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

* [API 格式](/guides/api-formats) — 了解 OpenAI、Responses、Anthropic 與 Gemini 路由之間的差異
* [IDE / SDK 相容性](/guides/ide-sdk-compatibility) — 了解何時使用 `/v1/responses` 較為適合
* [錯誤處理](/guides/error-handling) — 學習常見失敗模式與復原策略
* [模型總覽](https://tokenlab.sh/zh-TW/models) — 在將模型接入代理前先瀏覽模型 ID