Skip to main content
安装官方 Tencent Cloud provider 插件，通过两个端点访问 Tencent Hy3：TokenHub（tencent-tokenhub）和 TokenPlan（tencent-tokenplan），使用 OpenAI 兼容 API。
属性值
提供商 idtencent-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 直接 CLI 标志--tokenhub-api-key <key>
TokenPlan 直接 CLI 标志--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

Create a Tencent API key

为 Tencent Cloud TokenHub 和 TokenPlan 创建 API key。如果你为该 key 选择了有限访问范围，请在允许的模型中包含 hy3（如果计划在 TokenHub 上使用，还要包含 hy3 preview）。
2

Run 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

Verify the model

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）text256,00064,000已启用推理
tencent-tokenhub/hy3hy3（TokenHub）text256,00064,000已启用推理
tencent-tokenplan/hy3hy3（TokenPlan）text256,00064,000已启用推理
hy3 是 Tencent Hunyuan 面向推理、长上下文指令遵循、代码和 agent 工作流的大型 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"
如果 Gateway 网关作为托管服务运行（launchd、systemd、Docker），TOKENHUB_API_KEY 和 TOKENPLAN_API_KEY 必须对该进程可见。请在 ~/.openclaw/.env 中设置它们，或通过 env.shellEnv 设置，以便 launchd、systemd 或 Docker exec 环境可以读取它们。
仅在交互式 shell 中导出的 key 对托管 Gateway 网关进程不可见。请使用 env 文件或配置接口来确保持续可用。

​
相关

Model providers

选择提供商、模型引用和故障转移行为。

Configuration reference

完整配置 schema，包括提供商设置。

Tencent TokenHub

Tencent Cloud 的 TokenHub 产品页面。

Hy3 preview model card

Tencent Hunyuan Hy3 preview 详情和基准测试。