腾讯云（TokenHub / TokenPlan）

hy3 的腾讯云 TokenHub 和 TokenPlan 设置

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

属性	值
提供商 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/hy3`

快速开始

创建腾讯 API key

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

运行新手引导

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

openclaw onboard --non-interactive \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY"

openclaw onboard --auth-choice tokenplan-api-key

openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"

export TOKENHUB_API_KEY=...
export TOKENPLAN_API_KEY=...

验证模型

openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan

非交互式设置

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

# TokenPlan
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY" \
  --skip-health \
  --accept-risk

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

内置目录

模型引用	名称	输入	上下文	最大输出	备注
`tencent-tokenhub/hy3-preview`	hy3 preview（TokenHub）	文本	256,000	64,000	支持推理
`tencent-tokenhub/hy3`	hy3（TokenHub）	文本	256,000	64,000	支持推理
`tencent-tokenplan/hy3`	hy3（TokenPlan）	文本	256,000	64,000	支持推理

hy3 是腾讯混元面向推理、长上下文指令遵循、代码和智能体工作流的大型 MoE 语言模型。腾讯的 OpenAI 兼容示例使用 hy3 作为模型 ID，并支持标准的聊天补全工具调用以及 reasoning_effort。

模型 ID 为 hy3。请勿将其与腾讯的 HY-3D-* 模型混淆；后者是 3D 生成 API，并非此提供商配置的 OpenClaw 聊天模型。

高级配置

覆盖端点

OpenClaw 的内置目录使用腾讯云的 https://tokenhub.tencentmaas.com/v1 端点。仅当你的 TokenHub 账户或区域要求使用其他端点时才覆盖它：

openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"

守护进程的环境变量可用性

如果 Gateway 网关作为托管服务运行（launchd、systemd、Docker），该进程必须能够访问 TOKENHUB_API_KEY 和 TOKENPLAN_API_KEY。请在 ~/.openclaw/.env 中设置它们，或通过 env.shellEnv 设置，以便 launchd、systemd 或 Docker exec 环境能够读取它们。

仅在交互式 shell 中导出的密钥对托管的 Gateway 网关进程不可见。请使用环境变量文件或配置接口来确保其持久可用。

腾讯云（TokenHub / TokenPlan）

快速开始

非交互式设置

内置目录

高级配置

相关内容