Appearance
OpenClaw 通过内置插件支持腾讯云 TokenHub 的 Hy3 preview 模型。完成配置前需在腾讯云 TokenHub 控制台创建 API key，然后执行 openclaw onboard --auth-choice tokenhub-api-key 交互式配置，也可通过 --tokenhub-api-key 直接传入密钥进行非交互式设置。注意 Hy3 preview 是推理增强型 MoE 模型，支持 256K 上下文和工具调用，且 TOKENHUB_API_KEY 环境变量必须持久化到后台进程环境（如 launchd、systemd、Docker），仅交互式 shell 中导出不会对守护进程生效。
OpenClaw 配置腾讯云 TokenHub Hy3 preview 模型
腾讯云 TokenHub 作为 OpenClaw 的内置提供商插件（bundled）提供，可通过 OpenAI 兼容的 API 端点 tencent-tokenhub 接入 Hy3 preview 模型。
| 属性 | 值 |
|---|---|
| Provider id | tencent-tokenhub |
| 插件状态 | 内置，enabledByDefault: true |
| 认证环境变量 | TOKENHUB_API_KEY |
| 引导式配置标志 | --auth-choice tokenhub-api-key |
| 直接 CLI 标志 | --tokenhub-api-key <key> |
| API 类型 | OpenAI 兼容（openai-completions） |
| 默认 Base URL | https://tokenhub.tencentmaas.com/v1 |
| 国际版 Base URL | https://tokenhub-intl.tencentmaas.com/v1（覆盖） |
| 默认模型 | tencent-tokenhub/hy3-preview |
快速开始
创建 TokenHub API key
在腾讯云 TokenHub 控制台创建 API key。如果选择受限访问范围，需在允许的模型中包含 **Hy3 preview**。
运行引导配置
bash
openclaw onboard --auth-choice tokenhub-api-keybash
openclaw onboard --non-interactive \
--auth-choice tokenhub-api-key \
--tokenhub-api-key "$TOKENHUB_API_KEY"bash
export TOKENHUB_API_KEY=...验证模型可用
```bash
openclaw models list --provider tencent-tokenhub
```
非交互式配置
bash
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 preview (TokenHub) | text | 256,000 | 64,000 | 默认模型；支持推理增强 |
Hy3 preview 是腾讯混元的大规模 MoE 语言模型，专为推理、长上下文指令跟随、代码和智能体工作流设计。腾讯的 OpenAI 兼容示例使用 hy3-preview 作为模型 ID，支持标准 chat-completions 工具调用及 reasoning_effort 参数。
<期提示> 模型 ID 为 hy3-preview。请勿将其与腾讯的 HY-3D-* 模型混淆，后者是 3D 生成 API，并非本提供商所配置的聊天模型。 </期提示>
分层定价
内置模型列表中包含按输入窗口长度分层的费用元数据，因此无需手动覆盖即可自动估算成本。
| 输入 token 范围 | 输入价格 (每百万 token) | 输出价格 (每百万 token) | 缓存读取价格 (每百万 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 下的配置覆盖。
高级配置
端点覆盖
OpenClaw 默认使用腾讯云端点 `https://tokenhub.tencentmaas.com/v1`。腾讯同时提供了国际版 TokenHub 端点：
```bash
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 环境能够读取。
<警告>
仅在交互式 shell 中导出的密钥在托管 Gateway 进程中不可见。请使用环境文件或配置接缝确保持久可用。
</警告>
相关
模型提供商
选择提供商、模型引用以及故障转移行为。
配置参考
完整的配置模式，包括提供商设置。
腾讯云 TokenHub
腾讯云 TokenHub 产品页面。
Hy3 preview 模型卡
腾讯混元 Hy3 preview 详情和基准测试。
常见问题
如何获取 TokenHub API key？
登录腾讯云 TokenHub 控制台，创建 API key。注意选择允许访问的模型时需包含 hy3-preview，否则后续调用会失败。
为什么 openclaw models list --provider tencent-tokenhub 返回错误？
最常见原因是 TOKENHUB_API_KEY 环境变量未设置或未传递给当前 shell。如果 Gateway 以守护进程运行，需将密钥写入 ~/.openclaw/.env 或通过配置项 env.shellEnv 持久化。
Hy3 preview 支持工具调用和 reasoning_effort 吗？
是的。Hy3 preview 支持标准 chat-completions 工具调用和 reasoning_effort 参数。使用 OpenAI 兼容 API，具体参数可参考腾讯官方文档。