本页内容
本页内容
供应商
Tencent Cloud (TokenHub / TokenPlan)
安装官方的Tencent Cloud接入腾讯混元聊天模型的provider插件(hy4-preview, hy3) 通过两个端点 —TokenHub (tencent-tokenhub) 和TokenPlan (tencent-tokenplan) — 使用OpenAI-兼容的API。
| 属性 | 值 |
|---|---|
| 提供商 ID | tencent-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> |
| API | OpenAI-兼容(openai-completions) |
| TokenHub 基础 URL | https://tokenhub.tencentmaas.com/v1 |
| TokenHub 全局基础 URL | https://tokenhub-intl.tencentmaas.com/v1(覆盖) |
| TokenPlan 基础 URL | https://api.lkeap.cloud.tencent.com/plan/v3 |
| 默认模型 | tencent-tokenhub/hy4-preview |
快速开始
创建腾讯API密钥
创建一个API关键是Tencent Cloud TokenHub和TokenPlan。如果您为密钥选择有限的访问范围,请包括hy4预览(和hy3 / hy3预览如果您打算使用它们TokenHub)在允许的模型中。
运行入门引导培训
验证模型
Onboarding 会保留您的模型条目,并将生成的目录行留给发现。对于 models.mode: "replace",它还会写入内置目录,因为该模式会跳过发现。
非交互式设置
内置目录
| 模型引用 | 名称 | 输入 | 上下文 | 最大输出 | 笔记 |
|---|---|---|---|---|---|
tencent-tokenhub/hy4-preview |
hy4 预览 (TokenHub) | 文本 | 1,024,000 | 64,000 | 推理能力强; 默认 |
tencent-tokenhub/hy3 |
hy3 (TokenHub) | 文本 | 256,000 | 128,000 | 推理能力强;上一页 GA |
tencent-tokenhub/hy3-preview |
hy3 预览 (TokenHub) | 文本 | 256,000 | 128,000 | 已弃用;使用hy4-preview |
tencent-tokenplan/hy4-preview |
hy4 预览 (TokenPlan) | 文本 | 1,024,000 | 64,000 | 推理能力强; 默认 |
tencent-tokenplan/hy3 |
hy3 (TokenPlan) | 文本 | 256,000 | 128,000 | 推理能力强;上一页 GA |
hy4-preview 是腾讯混元的大型 MoE 语言模型,用于推理、长上下文指令跟踪、代码和代理工作流程。腾讯的 OpenAI- 兼容示例使用 hy4-preview 作为模型 ID,并支持标准聊天完成工具调用以及 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 的内置目录使用 Tencent Cloud 的 https://tokenhub.tencentmaas.com/v1 端点。仅当您的 TokenHub 帐户或区域需要不同的帐户或区域时才覆盖它:
守护进程的环境可用性
如果 Gateway 作为托管服务运行(launchd、systemd、Docker),TOKENHUB_API_KEY 和 TOKENPLAN_API_KEY 必须对该进程可见。请在 ~/.openclaw/.env 中设置它们,或通过 env.shellEnv 设置,以便 launchd、systemd 或 Docker exec 环境可以读取它们。