騰訊雲端（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 初始設定旗標	--auth-choice tokenhub-api-key
TokenPlan 初始設定旗標	--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

​

快速開始

1. 建立 Tencent API 金鑰

   為 Tencent Cloud TokenHub 和 TokenPlan 建立 API 金鑰。如果為金鑰選擇受限的存取範圍，請將 hy3（若計畫在 TokenHub 上使用 hy3 preview，也請一併加入）納入允許的模型。

2. 執行初始設定

   TokenHub 初始設定

   openclaw onboard --auth-choice tokenhub-api-key
   
3. 驗證模型

   openclaw models list --provider tencent-tokenhub
   openclaw models list --provider tencent-tokenplan
   

​

非互動式設定

# 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

除了 --non-interactive 之外，也必須提供 --accept-risk。

​

內建目錄

模型參照	名稱	輸入	上下文	最大輸出	備註
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，並支援標準聊天補全工具呼叫以及 reasoning_effort。

模型 ID 是 hy3。請勿與 Tencent 的 HY-3D-* 模型混淆；後者是 3D 生成 API，並非此提供者所設定的 OpenClaw 聊天模型。

​

進階設定

覆寫端點

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

openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"

守護程序的環境變數可用性

如果閘道以受管理服務執行（launchd、systemd、Docker），該程序必須能存取 TOKENHUB_API_KEY 和 TOKENPLAN_API_KEY。請在 ~/.openclaw/.env 中設定，或透過 env.shellEnv 設定，讓 launchd、systemd 或 Docker exec 環境可以讀取它們。

僅在互動式 shell 中匯出的金鑰，受管理的閘道程序無法存取。請使用環境變數檔案或設定介面，確保持續可用。

​

相關內容

模型提供者

選擇提供者、模型參照及容錯移轉行為。

設定參考

包含提供者設定的完整設定結構描述。

Tencent TokenHub

Tencent Cloud 的 TokenHub 產品頁面。

Hy3 preview 模型卡

Tencent Hunyuan Hy3 preview 的詳細資訊與基準測試。