本页内容

本页内容

供应商

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)在允许的模型中。

  • 运行入门引导培训

    TokenHub onboarding
    openclaw onboard --auth-choice tokenhub-api-key
    TokenHub direct flag
    openclaw onboard --non-interactive --accept-risk --skip-health \  --auth-choice tokenhub-api-key \  --tokenhub-api-key "$TOKENHUB_API_KEY"
    TokenPlan onboarding
    openclaw onboard --auth-choice tokenplan-api-key
    TokenPlan direct flag
    openclaw onboard --non-interactive --accept-risk --skip-health \  --auth-choice tokenplan-api-key \  --tokenplan-api-key "$TOKENPLAN_API_KEY"
    Env only
    export TOKENHUB_API_KEY=...export TOKENPLAN_API_KEY=...
  • 验证模型

    bash
    openclaw models list --provider tencent-tokenhubopenclaw models list --provider tencent-tokenplan
  • Onboarding 会保留您的模型条目,并将生成的目录行留给发现。对于 models.mode: "replace",它还会写入内置目录,因为该模式会跳过发现。

    非交互式设置

    bash
    # TokenHubopenclaw onboard --non-interactive \  --mode local \  --auth-choice tokenhub-api-key \  --tokenhub-api-key "$TOKENHUB_API_KEY" \  --skip-health \  --accept-risk # TokenPlanopenclaw onboard --non-interactive \  --mode local \  --auth-choice tokenplan-api-key \  --tokenplan-api-key "$TOKENPLAN_API_KEY" \  --skip-health \  --accept-risk

    内置目录

    模型引用 名称 输入 上下文 最大输出 笔记
    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 帐户或区域需要不同的帐户或区域时才覆盖它:

    bash
    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 环境可以读取它们。

    相关内容

    本页有帮助吗?