Providers
Tencent Cloud (TokenHub)
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.
| Property | Value |
|---|---|
| Provider id | tencent-tokenhub |
| Plugin | bundled, enabledByDefault: true |
| Auth env var | TOKENHUB_API_KEY |
| Onboarding flag | --auth-choice tokenhub-api-key |
| Direct CLI flag | --tokenhub-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| Default base URL | https://tokenhub.tencentmaas.com/v1 |
| Global base URL | https://tokenhub-intl.tencentmaas.com/v1 (override) |
| Default model | tencent-tokenhub/hy3-preview |
Quick start
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.
Run 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=...
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 ref | Name | Input | Context | Max output | Notes |
|---|---|---|---|---|---|
tencent-tokenhub/hy3-preview |
Hy3 preview (TokenHub) | text | 256,000 | 64,000 | Default; 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.
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 range | Input rate | Output rate | Cache read |
|---|---|---|---|
| 0 - 16,000 | 0.176 | 0.587 | 0.059 |
| 16,000 - 32,000 | 0.235 | 0.939 | 0.088 |
| 32,000+ | 0.293 | 1.173 | 0.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
Endpoint override
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.
Environment availability for the daemon
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.