> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 騰訊雲（TokenHub / TokenPlan）

安裝官方 Tencent Cloud 提供者外掛，透過兩個端點 TokenHub (`tencent-tokenhub`) 和 TokenPlan (`tencent-tokenplan`) 使用 OpenAI 相容 API 存取 Tencent Hy3。

| 屬性                      | 值                                              |
| ----------------------- | ---------------------------------------------- |
| 提供者 ID                  | `tencent-tokenhub`, `tencent-tokenplan`        |
| 套件                      | `@openclaw/tencent-provider`                   |
| TokenHub 驗證環境變數         | `TOKENHUB_API_KEY`                             |
| TokenPlan 驗證環境變數        | `TOKENPLAN_API_KEY`                            |
| TokenHub onboarding 旗標  | `--auth-choice tokenhub-api-key`               |
| TokenPlan onboarding 旗標 | `--auth-choice tokenplan-api-key`              |
| TokenHub 直接命令列介面旗標      | `--tokenhub-api-key <key>`                     |
| TokenPlan 直接命令列介面旗標     | `--tokenplan-api-key <key>`                    |
| API                     | OpenAI 相容 (`openai-completions`)               |
| TokenHub 基礎 URL         | `https://tokenhub.tencentmaas.com/v1`          |
| TokenHub 全球基礎 URL       | `https://tokenhub-intl.tencentmaas.com/v1`（覆寫） |
| TokenPlan 基礎 URL        | `https://api.lkeap.cloud.tencent.com/plan/v3`  |
| 預設模型                    | `tencent-tokenhub/hy3`                         |

## 快速開始

<Steps>
  <Step title="建立 Tencent API 金鑰">
    為 Tencent Cloud TokenHub 和 TokenPlan 建立 API 金鑰。如果你為金鑰選擇受限的存取範圍，請將 **hy3**（如果你計畫在 TokenHub 上使用，也包含 **hy3 preview**）加入允許的模型。
  </Step>

  <Step title="執行 onboarding">
    <CodeGroup>
      ```bash TokenHub onboarding theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice tokenhub-api-key
      ```

      ```bash TokenHub 直接旗標 theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive \
        --auth-choice tokenhub-api-key \
        --tokenhub-api-key "$TOKENHUB_API_KEY"
      ```

      ```bash TokenPlan onboarding theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice tokenplan-api-key
      ```

      ```bash TokenPlan 直接旗標 theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive \
        --auth-choice tokenplan-api-key \
        --tokenplan-api-key "$TOKENPLAN_API_KEY"
      ```

      ```bash 僅使用 Env theme={"theme":{"light":"min-light","dark":"min-dark"}}
      export TOKENHUB_API_KEY=...
      export TOKENPLAN_API_KEY=...
      ```
    </CodeGroup>
  </Step>

  <Step title="驗證模型">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider tencent-tokenhub
    openclaw models list --provider tencent-tokenplan
    ```
  </Step>
</Steps>

## 非互動式設定

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# TokenHub
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk

# TokenPlan
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY" \
  --skip-health \
  --accept-risk
```

<Note>
  `--accept-risk` 必須與 `--non-interactive` 搭配使用。
</Note>

## 內建目錄

| 模型參照                           | 名稱                     | 輸入 | 上下文     | 最大輸出   | 備註    |
| ------------------------------ | ---------------------- | -- | ------- | ------ | ----- |
| `tencent-tokenhub/hy3-preview` | hy3 preview (TokenHub) | 文字 | 256,000 | 64,000 | 已啟用推理 |
| `tencent-tokenhub/hy3`         | hy3 (TokenHub)         | 文字 | 256,000 | 64,000 | 已啟用推理 |
| `tencent-tokenplan/hy3`        | hy3 (TokenPlan)        | 文字 | 256,000 | 64,000 | 已啟用推理 |

hy3 是 Tencent Hunyuan 的大型 MoE 語言模型，適用於推理、長上下文指令遵循、程式碼和代理工作流程。Tencent 的 OpenAI 相容範例使用 `hy3` 作為模型 ID，並支援標準 chat-completions 工具呼叫和 `reasoning_effort`。

<Tip>
  模型 ID 是 `hy3`。請勿將其與 Tencent 的 `HY-3D-*` 模型混淆；那些是 3D 生成 API，不是此提供者設定的 OpenClaw 聊天模型。
</Tip>

## 進階設定

<AccordionGroup>
  <Accordion title="端點覆寫">
    OpenClaw 的內建目錄使用 Tencent Cloud 的 `https://tokenhub.tencentmaas.com/v1` 端點。只有在你的 TokenHub 帳戶或區域需要不同端點時才覆寫：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
    ```
  </Accordion>

  <Accordion title="daemon 的環境可用性">
    如果閘道以受管理服務執行（launchd、systemd、Docker），`TOKENHUB_API_KEY` 和 `TOKENPLAN_API_KEY` 必須對該程序可見。請在 `~/.openclaw/.env` 中設定，或透過 `env.shellEnv` 設定，讓 launchd、systemd 或 Docker exec 環境可以讀取。

    <Warning>
      只在互動式 shell 中匯出的金鑰，受管理的閘道程序不可見。請使用 env 檔案或設定接縫，以確保持久可用。
    </Warning>
  </Accordion>
</AccordionGroup>

## 相關

<CardGroup cols={2}>
  <Card title="模型提供者" href="/zh-TW/concepts/model-providers" icon="layers">
    選擇提供者、模型參照和容錯移轉行為。
  </Card>

  <Card title="設定參考" href="/zh-TW/gateway/configuration-reference" icon="gear">
    完整設定結構描述，包含提供者設定。
  </Card>

  <Card title="Tencent TokenHub" href="https://cloud.tencent.com/product/tokenhub" icon="arrow-up-right-from-square">
    Tencent Cloud 的 TokenHub 產品頁面。
  </Card>

  <Card title="Hy3 preview 模型卡" href="https://huggingface.co/tencent/Hy3-preview" icon="square-poll-horizontal">
    Tencent Hunyuan Hy3 preview 詳細資訊與基準測試。
  </Card>
</CardGroup>