Pular para o conteúdo principal
Instale o Plugin provedor oficial da Tencent Cloud para acessar o Tencent Hy3 preview pelo endpoint TokenHub (tencent-tokenhub) usando uma API compatível com OpenAI.
PropriedadeValor
ID do provedortencent-tokenhub
Pacote@openclaw/tencent-provider
Var. env de authTOKENHUB_API_KEY
Flag de onboarding--auth-choice tokenhub-api-key
Flag direta da CLI--tokenhub-api-key <key>
APICompatível com OpenAI (openai-completions)
URL base padrãohttps://tokenhub.tencentmaas.com/v1
URL base globalhttps://tokenhub-intl.tencentmaas.com/v1 (substituição)
Modelo padrãotencent-tokenhub/hy3-preview

​
Início rápido

1

Instale o Plugin

openclaw plugins install @openclaw/tencent-provider
2

Crie uma chave de API do TokenHub

Crie uma chave de API no Tencent Cloud TokenHub. Se você escolher um escopo de acesso limitado para a chave, inclua Hy3 preview nos modelos permitidos.
3

Execute o onboarding

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

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

export TOKENHUB_API_KEY=...
4

Verifique o modelo

openclaw models list --provider tencent-tokenhub

​
Configuração não interativa

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

​
Catálogo integrado

Ref. do modeloNomeEntradaContextoSaída máx.Observações
tencent-tokenhub/hy3-previewHy3 preview (TokenHub)texto256,00064,000Padrão; com raciocínio habilitado
Hy3 preview é o grande modelo de linguagem MoE Tencent Hunyuan para raciocínio, seguimento de instruções com contexto longo, código e fluxos de trabalho de agentes. Os exemplos compatíveis com OpenAI da Tencent usam hy3-preview como ID do modelo e dão suporte a chamadas de ferramentas padrão de chat-completions, além de reasoning_effort.
O ID do modelo é hy3-preview. Não o confunda com os modelos HY-3D-* da Tencent, que são APIs de geração 3D e não são o modelo de chat do OpenClaw configurado por este provedor.

​
Preços por faixa

O catálogo do provedor inclui metadados de custo por faixa que escalam conforme o tamanho da janela de entrada, portanto as estimativas de custo são preenchidas sem substituições manuais.
Faixa de tokens de entradaTaxa de entradaTaxa de saídaLeitura de cache
0 - 16,0000.1760.5870.059
16,000 - 32,0000.2350.9390.088
32,000+0.2931.1730.117
As taxas são por milhão de tokens em USD, conforme anunciado pela Tencent. Substitua os preços em models.providers.tencent-tokenhub somente quando precisar de uma superfície diferente.

​
Configuração avançada

O padrão do OpenClaw é o endpoint https://tokenhub.tencentmaas.com/v1 da Tencent Cloud. A Tencent também documenta um endpoint internacional do TokenHub:
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
Substitua o endpoint somente quando sua conta ou região do TokenHub exigir isso.
Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), TOKENHUB_API_KEY deve estar visível para esse processo. Defina-a em ~/.openclaw/.env ou via env.shellEnv para que os ambientes launchd, systemd ou Docker exec possam lê-la.
Chaves exportadas apenas em um shell interativo não ficam visíveis para processos gerenciados do Gateway. Use o arquivo env ou a superfície de configuração para disponibilidade persistente.

​
Relacionados

Provedores de modelo

Escolha de provedores, refs. de modelo e comportamento de failover.

Referência de configuração

Esquema de configuração completo, incluindo configurações de provedor.

Tencent TokenHub

Página do produto TokenHub da Tencent Cloud.

Card do modelo Hy3 preview

Detalhes e benchmarks do Tencent Hunyuan Hy3 preview.