Skip to main content
Install the official Tencent Cloud provider plugin to access Tencent Hy3 through two endpoints — TokenHub (tencent-tokenhub) and TokenPlan (tencent-tokenplan) — using an OpenAI-compatible API.
PropertyValue
Provider idstencent-tokenhub, tencent-tokenplan
Package@openclaw/tencent-provider
TokenHub auth env varTOKENHUB_API_KEY
TokenPlan auth env varTOKENPLAN_API_KEY
TokenHub onboarding flag--auth-choice tokenhub-api-key
TokenPlan onboarding flag--auth-choice tokenplan-api-key
TokenHub direct CLI flag--tokenhub-api-key <key>
TokenPlan direct CLI flag--tokenplan-api-key <key>
APIOpenAI-compatible (openai-completions)
TokenHub base URLhttps://tokenhub.tencentmaas.com/v1
TokenHub global base URLhttps://tokenhub-intl.tencentmaas.com/v1 (override)
TokenPlan base URLhttps://api.lkeap.cloud.tencent.com/plan/v3
Default modeltencent-tokenhub/hy3

​
Quick start

1

Create a Tencent API key

Create an API key for Tencent Cloud TokenHub and TokenPlan. If you choose a limited access scope for the key, include hy3 (and hy3 preview if you plan to use it on TokenHub) in the allowed models.
2

Run onboarding

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

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

openclaw onboard --auth-choice tokenplan-api-key

openclaw onboard --non-interactive \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY"

export TOKENHUB_API_KEY=...
export TOKENPLAN_API_KEY=...
3

Verify the model

openclaw models list --provider tencent-tokenhub
openclaw models list --provider tencent-tokenplan

​
Non-interactive setup

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

# TokenPlan
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice tokenplan-api-key \
  --tokenplan-api-key "$TOKENPLAN_API_KEY" \
  --skip-health \
  --accept-risk
--accept-risk is required alongside --non-interactive.

​
Built-in catalog

Model refNameInputContextMax outputNotes
tencent-tokenhub/hy3-previewhy3 preview (TokenHub)text256,00064,000reasoning-enabled
tencent-tokenhub/hy3hy3 (TokenHub)text256,00064,000reasoning-enabled
tencent-tokenplan/hy3hy3 (TokenPlan)text256,00064,000reasoning-enabled
hy3 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 as the model id and support standard chat-completions tool calling plus reasoning_effort.
The model id is hy3. 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.

​
Advanced configuration

OpenClaw’s built-in catalog uses Tencent Cloud’s https://tokenhub.tencentmaas.com/v1 endpoint. Override it only if your TokenHub account or region requires a different one:
openclaw config set models.providers.tencent-tokenhub.baseUrl "https://your-endpoint/v1"
If the Gateway runs as a managed service (launchd, systemd, Docker), TOKENHUB_API_KEY and TOKENPLAN_API_KEY must be visible to that process. Set them in ~/.openclaw/.env or via env.shellEnv so launchd, systemd, or Docker exec environments can read them.
Keys exported only in an interactive shell 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.