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).

The provider uses an OpenAI-compatible API.

Property	Value
Provider	`tencent-tokenhub`
Default model	`tencent-tokenhub/hy3-preview`
Auth	`TOKENHUB_API_KEY`
API	OpenAI-compatible chat completions
Base URL	`https://tokenhub.tencentmaas.com/v1`
Global URL	`https://tokenhub-intl.tencentmaas.com/v1`

Quick start

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. ```bash openclaw onboard --auth-choice tokenhub-api-key ``` ```bash 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.

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.

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.

Notes

TokenHub model refs use tencent-tokenhub/<modelId>.
The bundled catalog currently includes hy3-preview.
The plugin marks Hy3 preview as reasoning-capable and streaming-usage capable.
The plugin ships with tiered Hy3 pricing metadata, so cost estimates are populated without manual pricing overrides.
Override pricing, context, or endpoint metadata in models.providers only when needed.

Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure TOKENHUB_API_KEY is available to that process (for example, in ~/.openclaw/.env or via env.shellEnv).

3.8 KiB Raw Blame History