跳轉到主要內容
安裝官方 Tencent Cloud 提供者外掛，透過兩個端點 TokenHub (tencent-tokenhub) 和 TokenPlan (tencent-tokenplan) 使用 OpenAI 相容 API 存取 Tencent Hy3。
屬性值
提供者 IDtencent-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>
APIOpenAI 相容 (openai-completions)
TokenHub 基礎 URLhttps://tokenhub.tencentmaas.com/v1
TokenHub 全球基礎 URLhttps://tokenhub-intl.tencentmaas.com/v1（覆寫）
TokenPlan 基礎 URLhttps://api.lkeap.cloud.tencent.com/plan/v3
預設模型tencent-tokenhub/hy3

​
快速開始

1

建立 Tencent API 金鑰

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

執行 onboarding

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

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

openclaw onboard --auth-choice tokenplan-api-key

openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"

export TOKENHUB_API_KEY=...
export TOKENPLAN_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
--accept-risk 必須與 --non-interactive 搭配使用。

​
內建目錄

模型參照名稱輸入上下文最大輸出備註
tencent-tokenhub/hy3-previewhy3 preview (TokenHub)文字256,00064,000已啟用推理
tencent-tokenhub/hy3hy3 (TokenHub)文字256,00064,000已啟用推理
tencent-tokenplan/hy3hy3 (TokenPlan)文字256,00064,000已啟用推理
hy3 是 Tencent Hunyuan 的大型 MoE 語言模型，適用於推理、長上下文指令遵循、程式碼和代理工作流程。Tencent 的 OpenAI 相容範例使用 hy3 作為模型 ID，並支援標準 chat-completions 工具呼叫和 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 中匯出的金鑰，受管理的閘道程序不可見。請使用 env 檔案或設定接縫，以確保持久可用。

​
相關

模型提供者

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

設定參考

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

Tencent TokenHub

Tencent Cloud 的 TokenHub 產品頁面。

Hy3 preview 模型卡

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