Skip to main content
安装官方腾讯云提供商插件，通过两个端点——TokenHub（tencent-tokenhub）和 TokenPlan（tencent-tokenplan）——使用 OpenAI 兼容 API 访问腾讯 Hy3。

​
快速开始

1

创建腾讯 API key

为腾讯云 TokenHub 和 TokenPlan 创建 API key。如果为该密钥选择受限访问范围，请在允许的模型中包含 hy3（如果计划在 TokenHub 上使用 hy3 preview，也请将其包含在内）。
2

运行新手引导

3

验证模型

​
非交互式设置

--accept-risk 必须与 --non-interactive 一同使用。

​
内置目录

hy3 是腾讯混元面向推理、长上下文指令遵循、代码和智能体工作流的大型 MoE 语言模型。腾讯的 OpenAI 兼容示例使用 hy3 作为模型 ID，并支持标准的聊天补全工具调用以及 reasoning_effort。
模型 ID 为 hy3。请勿将其与腾讯的 HY-3D-* 模型混淆；后者是 3D 生成 API，并非此提供商配置的 OpenClaw 聊天模型。

​
高级配置

OpenClaw 的内置目录使用腾讯云的 https://tokenhub.tencentmaas.com/v1 端点。仅当你的 TokenHub 账户或区域要求使用其他端点时才覆盖它：
如果 Gateway 网关作为托管服务运行（launchd、systemd、Docker），该进程必须能够访问 TOKENHUB_API_KEY 和 TOKENPLAN_API_KEY。请在 ~/.openclaw/.env 中设置它们，或通过 env.shellEnv 设置，以便 launchd、systemd 或 Docker exec 环境能够读取它们。
仅在交互式 shell 中导出的密钥对托管的 Gateway 网关进程不可见。请使用环境变量文件或配置接口来确保其持久可用。

​
相关内容

模型提供商

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

配置参考

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

腾讯 TokenHub

腾讯云的 TokenHub 产品页面。

Hy3 preview 模型卡片

腾讯混元 Hy3 preview 的详细信息和基准测试。