OpenClaw 的 Tencent 插件提供 TokenHub 与 TokenPlan 两个端点;Hy4-Flash 的模型引用分别是 tencent-tokenhub/hy4-flash 和 tencent-tokenplan/hy4-flash。
适合的任务:在 OpenClaw 中配置腾讯云 TokenHub 或 TokenPlan,并按端点选择 Hy4-Flash。
不适合的任务:将本文的提供方 ID、认证变量或模型引用用于其他客户端或 API。
适用的模型版本:Tencent Hunyuan Hy4-Flash。
适用的客户端、Agent 或 API:OpenClaw Tencent 官方提供方插件 @openclaw/tencent-provider。
推荐的推理档位和参数:默认 high。OpenClaw 将 reasoning_effort 发送为 none 或 high;其他思考档位映射为 high。
| 端点 | 模型引用 | 凭据环境变量 | OpenClaw 授权选项 |
|---|---|---|---|
| TokenHub | tencent-tokenhub/hy4-flash | TOKENHUB_API_KEY | tokenhub-api-key |
| TokenPlan | tencent-tokenplan/hy4-flash | TOKENPLAN_API_KEY | tokenplan-api-key |
Hy4-Flash 在两种端点的目录中均标记为快速档、支持图像输入和推理。上下文窗口为 1,048,576 tokens,最大输出为 65,536 tokens。
先在对应腾讯云服务创建 API Key,并将密钥放入当前 shell 环境变量。以下命令在 Gateway 主机运行;--accept-risk 是非交互模式要求的参数。
TokenHub:
export TOKENHUB_API_KEY="<TOKENHUB_API_KEY>"
openclaw onboard --non-interactive \
--mode local \
--auth-choice tokenhub-api-key \
--tokenhub-api-key "$TOKENHUB_API_KEY" \
--skip-health \
--accept-riskTokenPlan:
export TOKENPLAN_API_KEY="<TOKENPLAN_API_KEY>"
openclaw onboard --non-interactive \
--mode local \
--auth-choice tokenplan-api-key \
--tokenplan-api-key "$TOKENPLAN_API_KEY" \
--skip-health \
--accept-risk列出两个端点的模型目录,确认 Hy4-Flash 可用:
openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan在 OpenClaw 配置中选择模型时,使用上表中与所选端点对应的完整模型引用。来源文档未给出设置默认模型的具体配置键或命令。
reasoning_effort 输入 | OpenClaw 发往 Tencent 的值 |
|---|---|
none | none |
high | high |
| 其他思考档位 | high |
| 未指定 | 默认 high |
选择 TokenHub 或 TokenPlan,并创建该端点的 API Key。
在运行 Gateway 的主机上执行对应的非交互式 onboarding 命令。
执行相应的 openclaw models list --provider ...,检查目录中是否列出 hy4-flash。
将模型配置引用设为对应端点的完整模型 ID。来源说明:新 onboarding 默认选中 hy4-preview,不会自动替换为 Hy4-Flash。
如需调整推理强度,只使用来源明确说明的映射;未指定时按 high 处理。
官方提供方页列出提供方 ID tencent-tokenhub、tencent-tokenplan,插件包 @openclaw/tencent-provider,API 类型为 OpenAI-compatible openai-completions。
TokenHub API Key 环境变量为 TOKENHUB_API_KEY,授权选项为 tokenhub-api-key,直接 CLI 参数为 --tokenhub-api-key <key>;TokenPlan 对应值为 TOKENPLAN_API_KEY、tokenplan-api-key、--tokenplan-api-key <key>。
页面内置模型目录分别列出 tencent-tokenhub/hy4-flash 与 tencent-tokenplan/hy4-flash,均说明支持图像、推理,属于 fast tier。
页面说明 Hy4-Flash 接受与 Hy4 相同的图像格式,输入上限为 983,040 tokens,窗口为 1,048,576 tokens;目录列出的最大输出为 65,536 tokens。
Hy4-Flash 的 OpenClaw 推理档位为 none 或 high,默认 high;其他思考档位会映射为 high。
TokenHub 默认基础 URL 为 https://tokenhub.tencentmaas.com/v1,国际版覆盖地址为 https://tokenhub-intl.tencentmaas.com/v1;TokenPlan 默认基础 URL 为 https://api.lkeap.cloud.tencent.com/plan/v3。
新 onboarding 在两个端点均默认选择 hy4-preview。页面说明模型可在 OpenClaw 目录中列出,或通过手动输入/配置的模型引用调用。
选择的 API Key 必须有对应模型的访问权限;受限密钥需要在授权范围中包含计划使用的模型。
远程模式 onboarding(--mode remote)只配置本地客户端连接,不会在服务器上配置提供方凭据;应在 Gateway 主机设置凭据。
TokenHub 国际版地址是文档所列的覆盖地址,不代表默认端点。
来源页说明的是 OpenClaw 插件行为。它没有提供默认模型设置的具体配置键,也没有说明按 TokenHub/TokenPlan 区分不同的推理档位映射,因此本文不推断这些配置。
页面将 Hy4-Flash 描述为快速档,并非独立性能测试;本文不据此推导具体延迟或效果优势。
在对应腾讯云端点创建 API Key,将其放入对应环境变量,在 Gateway 主机运行 onboarding 命令,再用模型目录命令核对提供方模型。不要将真实 API Key 写入配置文档或命令历史。本文记录的目录和参数来自 2026-11-17 采集时可见的 OpenClaw 官方提供方页。
Hy4 Flash