Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

腾讯云作为 OpenClaw 的内置提供商插件提供。它通过 TokenHub 端点（tencent-tokenhub）使用 OpenAI 兼容 API 访问腾讯 Hy3 preview。
属性值
提供商 idtencent-tokenhub
插件内置，enabledByDefault: true
认证环境变量TOKENHUB_API_KEY
新手引导标志--auth-choice tokenhub-api-key
直接 CLI 标志--tokenhub-api-key <key>
APIOpenAI 兼容（openai-completions）
默认 base URLhttps://tokenhub.tencentmaas.com/v1
全球 base URLhttps://tokenhub-intl.tencentmaas.com/v1（覆盖）
默认模型tencent-tokenhub/hy3-preview

​
快速开始

1

创建 TokenHub API key

在腾讯云 TokenHub 中创建 API key。如果你为该 key 选择了受限访问范围，请在允许的模型中包含 Hy3 preview。
2

运行新手引导

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

验证模型

openclaw models list --provider tencent-tokenhub

​
非交互式设置

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

​
内置目录

模型引用名称输入上下文最大输出备注
tencent-tokenhub/hy3-previewHy3 preview（TokenHub）text256,00064,000默认；支持推理
Hy3 preview 是腾讯混元的大型 MoE 语言模型，适用于推理、长上下文指令遵循、代码和智能体工作流。腾讯的 OpenAI 兼容示例使用 hy3-preview 作为模型 id，并支持标准 chat-completions 工具调用以及 reasoning_effort。
模型 id 是 hy3-preview。不要将它与腾讯的 HY-3D-* 模型混淆，后者是 3D 生成 API，并不是此提供商配置的 OpenClaw 聊天模型。

​
分级定价

内置目录带有分级成本元数据，会随输入窗口长度缩放，因此无需手动覆盖也能填充成本估算。
输入 token 范围输入费率输出费率缓存读取
0 - 16,0000.1760.5870.059
16,000 - 32,0000.2350.9390.088
32,000+0.2931.1730.117
费率按腾讯公布的每百万 token 美元价格计算。仅当你需要不同的表面时，才在 models.providers.tencent-tokenhub 下覆盖定价。

​
高级配置

OpenClaw 默认使用腾讯云的 https://tokenhub.tencentmaas.com/v1 端点。腾讯还记录了一个国际版 TokenHub 端点：
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 环境可以读取它。
仅在 ~/.profile 中设置的 key 对托管 gateway 进程不可见。请使用 env 文件或配置 seam 来实现持久可用性。

​
相关内容

模型提供商

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

配置参考

完整配置 schema，包括提供商设置。

Tencent TokenHub

腾讯云 TokenHub 产品页。

Hy3 preview 模型卡

腾讯混元 Hy3 preview 详情和基准测试。