Skip to main content
Tencent Cloud is provided with OpenClaw as a bundled provider plugin. It uses the OpenAI-compatible API via the TokenHub endpoint (tencent-tokenhub) to give you access to the Tencent Hy3 preview.
PropertyValue
Provider idtencent-tokenhub
Pluginbundled, enabledByDefault: true
Auth env varTOKENHUB_API_KEY
Onboarding flag--auth-choice tokenhub-api-key
Direct CLI flag--tokenhub-api-key <key>
APIOpenAI-compatible (openai-completions)
Default base URLhttps://tokenhub.tencentmaas.com/v1
Global base URLhttps://tokenhub-intl.tencentmaas.com/v1 (override)
Default modeltencent-tokenhub/hy3-preview

​
Quick start

1

Create a TokenHub API key

Create an API key in Tencent Cloud TokenHub. If you choose a limited access scope for this key, include Hy3 preview in the allowed models.
2

Run onboarding

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

Verify models

openclaw models list --provider tencent-tokenhub

​
Non-interactive setup

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

​
Built-in catalog

Model referenceNameInputContextMax outputNotes
tencent-tokenhub/hy3-previewHy3 preview (TokenHub)Text256,00064,000Default; supports reasoning
Hy3 preview is a large MoE language model from Tencent Hunyuan, suitable for reasoning, long-context instruction following, code, and agent workflows. Tencent’s OpenAI-compatible example uses hy3-preview as the model id and supports standard chat-completions tool calling as well as reasoning_effort.
The model id is hy3-preview. Do not confuse it with Tencent’s HY-3D-* models, which are 3D generation APIs and not the OpenClaw chat model configured by this provider.

​
Tiered pricing

The bundled catalog includes tiered cost metadata that varies with input window length, so cost estimates can be populated without manual overrides.
Input token rangeInput rateOutput rateCache read
0 - 16,0000.1760.5870.059
16,000 - 32,0000.2350.9390.088
32,000+0.2931.1730.117
Rates are calculated according to Tencent’s published standard, in USD per million tokens. Override pricing under models.providers.tencent-tokenhub only if you need a different display.

​
Advanced configuration

OpenClaw uses Tencent Cloud’s https://tokenhub.tencentmaas.com/v1 endpoint by default. Tencent also provides an international TokenHub endpoint:
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
Override this endpoint only if your TokenHub account or region requires it.
If the Gateway runs as a managed service (launchd, systemd, Docker), TOKENHUB_API_KEY must be visible to that process. Set it in ~/.openclaw/.env, or via env.shellEnv, so launchd, systemd, or Docker exec environments can read it.
仅在交互式 shell 中导出的密钥对受管理的 gateway 进程不可见。请使用 env 文件或 config seam 以确保持久可用。

​
Related content

Model providers

Choose providers, model references, and failover behavior.

Configuration reference

Full configuration schema including provider settings.

Tencent TokenHub

Product page for Tencent Cloud TokenHub.

Hy3 preview model card

Details and benchmarks for Tencent Hunyuan Hy3 preview.