騰訊雲 (TokenHub)

騰訊雲作為 OpenClaw 中的內建供應商插件隨附。它使用與 OpenAI 相容的 API，透過 TokenHub 端點 (tencent-tokenhub) 提供對騰訊 Hy3 預覽的存取權。

屬性	值
供應商 ID	`tencent-tokenhub`
插件	內建，`enabledByDefault: true`
認證環境變數	`TOKENHUB_API_KEY`
入門旗標	`--auth-choice tokenhub-api-key`
直接 CLI 旗標	`--tokenhub-api-key <key>`
API	OpenAI 相容 (`openai-completions`)
預設基礎 URL	`https://tokenhub.tencentmaas.com/v1`
全域基礎 URL	`https://tokenhub-intl.tencentmaas.com/v1` (覆寫)
預設模型	`tencent-tokenhub/hy3-preview`

快速開始

建立 TokenHub API 金鑰
在騰訊雲 TokenHub 中建立 API 金鑰。如果您選擇了金鑰的有限存取範圍，請在允許的模型中包含 Hy3 preview。

執行入門程序

openclaw onboard --auth-choice tokenhub-api-key

openclaw onboard --non-interactive \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY"

export TOKENHUB_API_KEY=...

Verify the model

openclaw models list --provider tencent-tokenhub

非互動式設定

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY" \
  --skip-health \
  --accept-risk

內建目錄

模型參照	名稱	輸入	語境	最大輸出	備註
`tencent-tokenhub/hy3-preview`	Hy3 預覽 (TokenHub)	文字	256,000	64,000	預設；具備推理能力

Hy3 預覽是騰訊混元的大規模 MoE 語言模型，適用於推理、長語境指令遵循、程式碼和代理工作流程。騰訊的 OpenAI 相容範例使用 hy3-preview 作為模型 ID，並支援標準的 chat-completions 工具呼叫以及 reasoning_effort。

分級定價

內建目錄隨附了隨輸入視窗長度縮放的分級成本元數據，因此無需手動覆寫即可填入成本估計值。

輸入 token 範圍	輸入費率	輸出費率	快取讀取
0 - 16,000	0.176	0.587	0.059
16,000 - 32,000	0.235	0.939	0.088
32,000+	0.293	1.173	0.117

費率為騰訊公佈的每百萬 Token 美元價格。僅在您需要不同的顯示價格時，才在 models.providers.tencent-tokenhub 下覆蓋定價。

進階設定

Endpoint override

OpenClaw 預設使用騰訊雲的 https://tokenhub.tencentmaas.com/v1 端點。騰訊也記載了國際版 TokenHub 端點：

openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"

僅在您的 TokenHub 帳號或區域有要求時才覆蓋端點。

守護行程的環境可用性

如果 Gateway 作為受控服務（launchd、systemd、Docker）運行，則該程序必須能夠存取 TOKENHUB_API_KEY。請在 ~/.openclaw/.env 中設定，或透過 env.shellEnv 設定，以便 launchd、systemd 或 Docker exec 環境能夠讀取它。