# 腾讯云（TokenHub / TokenPlan）

> hy3 的腾讯云 TokenHub 和 TokenPlan 设置

- 网址：https://funcoding.ai/agents/openclaw/providers/tencent/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/tencent

---
安装官方腾讯云提供商插件，通过两个端点——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**，也请将其包含在内）。

**运行新手引导**

```bash TokenHub onboarding
openclaw onboard --auth-choice tokenhub-api-key
```

```bash TokenHub direct flag
openclaw onboard --non-interactive \
  --auth-choice tokenhub-api-key \
  --tokenhub-api-key "$TOKENHUB_API_KEY"
```

```bash TokenPlan onboarding
openclaw onboard --auth-choice tokenplan-api-key
```

```bash TokenPlan direct flag
openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"
```

```bash Env only
export TOKENHUB_API_KEY=...
export TOKENPLAN_API_KEY=...
```

**验证模型**

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

## 非交互式设置

```bash
# 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
```

<div class="callout callout-note">

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

</div>

## 内置目录

| 模型引用                       | 名称                   | 输入 | 上下文  | 最大输出 | 备注       |
| ------------------------------ | ---------------------- | ---- | ------- | -------- | ---------- |
| `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`。

<div class="callout callout-tip">

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

</div>

## 高级配置

<details>
<summary>覆盖端点</summary>

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

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

</details>

<details>
<summary>守护进程的环境变量可用性</summary>

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

<div class="callout callout-warning">

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

</div>

</details>

## 相关内容

- [模型提供商](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：完整的配置架构，包括提供商设置。
- [腾讯 TokenHub](https://cloud.tencent.com/product/tokenhub)：腾讯云的 TokenHub 产品页面。
- [Hy3 preview 模型卡片](https://huggingface.co/tencent/Hy3-preview)：腾讯混元 Hy3 preview 的详细信息和基准测试。