快速开始

腾讯云(TokenHub / TokenPlan)

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

属性
提供商 ID tencent-tokenhubtencent-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 密钥

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

  • 运行新手引导

    TokenHub 新手引导
    openclaw onboard --auth-choice tokenhub-api-key
    TokenHub 直接标志
    openclaw onboard --non-interactive \--auth-choice tokenhub-api-key \--tokenhub-api-key "$TOKENHUB_API_KEY"
    TokenPlan 新手引导
    openclaw onboard --auth-choice tokenplan-api-key
    TokenPlan 直接标志
    openclaw onboard --non-interactive \--auth-choice tokenplan-api-key \--tokenplan-api-key "$TOKENPLAN_API_KEY"
    仅使用环境变量
    export TOKENHUB_API_KEY=...export TOKENPLAN_API_KEY=...
  • 验证模型

    bash
    openclaw models list --provider tencent-tokenhubopenclaw models list --provider tencent-tokenplan
  • 非交互式设置

    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/hy3-preview hy3 预览版(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

    高级配置

    端点覆盖

    OpenClaw 的内置目录使用腾讯云的 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_KEYTOKENPLAN_API_KEY 必须对该进程可见。请在 ~/.openclaw/.env 中设置它们,或通过 env.shellEnv 设置,以便 launchd、systemd 或 Docker 的执行环境能够读取它们。

    相关内容

    Was this useful?
    On this page

    On this page