Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tencent Cloud ships as a bundled provider plugin in OpenClaw. It gives access to Tencent Hy3 preview through the TokenHub endpoint (tencent-tokenhub) using an OpenAI-compatible API.
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 the key, include Hy3 preview in the allowed models.
2

Run onboarding

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

Verify the model

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 refNameInputContextMax outputNotes
tencent-tokenhub/hy3-previewHy3 preview (TokenHub)text256,00064,000Default; reasoning-enabled
Hy3 preview is Tencent Hunyuan’s large MoE language model for reasoning, long-context instruction following, code, and agent workflows. Tencent’s OpenAI-compatible examples use hy3-preview as the model id and support standard chat-completions tool calling plus reasoning_effort.
The model id is hy3-preview. Do not confuse it with Tencent’s HY-3D-* models, which are 3D generation APIs and are not the OpenClaw chat model configured by this provider.

​
Tiered pricing

The bundled catalog ships tiered cost metadata that scales with input window length, so cost estimates are populated without manual overrides.
Input tokens 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 per million tokens in USD as advertised by Tencent. Override pricing under models.providers.tencent-tokenhub only when you need a different surface.

​
Advanced configuration

OpenClaw defaults to Tencent Cloud’s https://tokenhub.tencentmaas.com/v1 endpoint. Tencent also documents an international TokenHub endpoint:
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
Only override the endpoint when 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.
Keys set only in ~/.profile are not visible to managed gateway processes. Use the env file or config seam for persistent availability.

Model providers

Choosing providers, model refs, and failover behavior.

Configuration reference

Full config schema including provider settings.

Tencent TokenHub

Tencent Cloud’s TokenHub product page.

Hy3 preview model card

Tencent Hunyuan Hy3 preview details and benchmarks.