Tencent Cloud (TokenHub / TokenPlan)

安装官方腾讯云提供商插件，通过两个端点——TokenHub（tencent-tokenhub）和 TokenPlan（tencent-tokenplan）——使用兼容 OpenAI 的 API 访问腾讯混元聊天模型（hy4-preview、hy3）。

快速开始¶

1. 创建腾讯 API 密钥

为腾讯云 TokenHub 和 TokenPlan 创建 API 密钥。如果你为密钥选择了受限的访问范围，请在允许的模型中包含 hy4 preview（如果计划在 TokenHub 上使用 hy3 / hy3 preview，也请一并包含）。

2. 运行引导

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

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

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

openclaw onboard --non-interactive --accept-risk --skip-health \
  --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

引导会保留你的模型条目，并将生成的目录行交由发现机制处理。使用 models.mode: "replace" 时，它还会写入内置目录，因为该模式会跳过发现。

非交互式设置¶

# 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

内置目录¶

hy4-preview 是腾讯混元的大型 MoE 语言模型，适用于推理、长上下文指令遵循、代码和智能体工作流。腾讯提供的 OpenAI 兼容示例以 hy4-preview 作为模型 ID，并支持标准的 chat-completions 工具调用以及 reasoning_effort。

现有 TokenHub 配置¶

全新引导会在两个端点上选择 hy4-preview。现有 TokenHub 配置遵循独立的迁移策略：当配置了 TokenHub 模型允许列表时，openclaw doctor --fix 会将已弃用的 tencent-tokenhub/hy3-preview 主模型更改为 tencent-tokenhub/hy3，而不是 Hy4。这适用于字符串和对象形式的主模型设置，并会保留回退模型、自定义别名和不相关的设置。显式指定的 hy3 和 hy4-preview 主模型保持不变。

目录对 hy3-preview 的推荐仍然是 hy4-preview，但它不是 Doctor 迁移的目标。迁移到 Hy4 是一个明确的选择：请查看其不同的定价，并验证所选端点的模型访问权限。

高级配置¶

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 中导出的密钥对受管网关进程不可见。请使用 env 文件或配置接缝以获得持久可用性。

相关¶

模型提供商

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

配置参考

包括提供商设置的完整配置架构。

Tencent TokenHub

Tencent Cloud 的 TokenHub 产品页面。

Hy3 预览模型卡片

Tencent Hunyuan Hy3 预览详情和基准测试。