Saltar al contenido principal
Instala el Plugin oficial del proveedor de Tencent Cloud para acceder a Tencent Hy3 a través de dos endpoints: TokenHub (tencent-tokenhub) y TokenPlan (tencent-tokenplan), usando una API compatible con OpenAI.
PropiedadValor
Ids de proveedortencent-tokenhub, tencent-tokenplan
Paquete@openclaw/tencent-provider
Variable de entorno auth TokenHubTOKENHUB_API_KEY
Variable de entorno auth TokenPlanTOKENPLAN_API_KEY
Flag de configuración inicial de TokenHub--auth-choice tokenhub-api-key
Flag de configuración inicial de TokenPlan--auth-choice tokenplan-api-key
Flag CLI directo de TokenHub--tokenhub-api-key <key>
Flag CLI directo de TokenPlan--tokenplan-api-key <key>
APICompatible con OpenAI (openai-completions)
URL base de TokenHubhttps://tokenhub.tencentmaas.com/v1
URL base global de TokenHubhttps://tokenhub-intl.tencentmaas.com/v1 (sobrescritura)
URL base de TokenPlanhttps://api.lkeap.cloud.tencent.com/plan/v3
Modelo predeterminadotencent-tokenhub/hy3

​
Inicio rápido

1

Crear una clave de API de Tencent

Crea una clave de API para Tencent Cloud TokenHub y TokenPlan. Si eliges un alcance de acceso limitado para la clave, incluye hy3 (y hy3 preview si planeas usarlo en TokenHub) en los modelos permitidos.
2

Ejecutar la configuración inicial

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=...
3

Verificar el modelo

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

​
Configuración no interactiva

# 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 es obligatorio junto con --non-interactive.

​
Catálogo integrado

Ref. del modeloNombreEntradaContextoSalida máximaNotas
tencent-tokenhub/hy3-previewhy3 preview (TokenHub)texto256,00064,000razonamiento habilitado
tencent-tokenhub/hy3hy3 (TokenHub)texto256,00064,000razonamiento habilitado
tencent-tokenplan/hy3hy3 (TokenPlan)texto256,00064,000razonamiento habilitado
hy3 es el modelo de lenguaje MoE grande de Tencent Hunyuan para razonamiento, seguimiento de instrucciones con contexto largo, código y flujos de trabajo de agentes. Los ejemplos compatibles con OpenAI de Tencent usan hy3 como id de modelo y admiten llamadas a herramientas estándar de chat completions, además de reasoning_effort.
El id de modelo es hy3. No lo confundas con los modelos HY-3D-* de Tencent, que son API de generación 3D y no son el modelo de chat de OpenClaw configurado por este proveedor.

​
Configuración avanzada

El catálogo integrado de OpenClaw usa el endpoint https://tokenhub.tencentmaas.com/v1 de Tencent Cloud. Sobrescríbelo solo si tu cuenta o región de TokenHub requiere uno diferente:
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
Si el Gateway se ejecuta como un servicio gestionado (launchd, systemd, Docker), TOKENHUB_API_KEY y TOKENPLAN_API_KEY deben ser visibles para ese proceso. Defínelos en ~/.openclaw/.env o mediante env.shellEnv para que los entornos de launchd, systemd o Docker exec puedan leerlos.
Las claves exportadas solo en un shell interactivo no son visibles para los procesos gestionados del gateway. Usa el archivo env o la vía de configuración para disponibilidad persistente.

​
Relacionado

Proveedores de modelos

Elección de proveedores, refs. de modelos y comportamiento de failover.

Referencia de configuración

Esquema de configuración completo, incluidos los ajustes de proveedores.

Tencent TokenHub

Página de producto TokenHub de Tencent Cloud.

Ficha del modelo Hy3 preview

Detalles y benchmarks de Tencent Hunyuan Hy3 preview.