openclaw/docs/providers/tencent.md at 8c19dbfb627cebc5edb613407246db643e9f5d68

mirror of https://github.com/openclaw/openclaw.git synced 2026-07-10 18:16:12 +00:00

Files

Peter Steinberger f7d7148cf0 docs: rewrite published docs grounded in current source (#100142 )

Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green.

Closes #100141

2026-07-05 00:32:47 -04:00

5.0 KiB

Raw Blame History

summary, title, read_when

summary

title

read_when

Tencent Cloud TokenHub setup for Hy3 preview

Tencent Cloud (TokenHub)

You want to use Tencent Hy3 preview with OpenClaw

You need the TokenHub API key setup

Install the official Tencent Cloud provider plugin to access Tencent Hy3 preview through the TokenHub endpoint (tencent-tokenhub) using an OpenAI-compatible API.

Property	Value
Provider id	`tencent-tokenhub`
Package	`@openclaw/tencent-provider`
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`)
Base URL	`https://tokenhub.tencentmaas.com/v1`
Default model	`tencent-tokenhub/hy3-preview`

Quick start

```bash openclaw plugins install @openclaw/tencent-provider ``` 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.

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

</CodeGroup>

```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

`--accept-risk` is required alongside `--non-interactive`.

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. It supports 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 provider 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

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:

```bash
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` 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.

<Warning>
  Keys exported only in an interactive shell are not visible to managed gateway processes. Use the env file or config seam for persistent availability.
</Warning>

Choosing providers, model refs, and failover behavior. Full config schema including provider settings. Tencent Cloud's TokenHub product page. Tencent Hunyuan Hy3 preview details and benchmarks.

5.0 KiB Raw Blame History