openclaw/docs/providers/tencent.md at main

mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 07:30:43 +00:00

Files

Vincent Koc 813fe0a3be docs(providers): rewrite Tencent, Mistral, and Inferrs with code-verified setup

Tencent (docs/providers/tencent.md): rewrote against
extensions/tencent/openclaw.plugin.json. Removed the duplicate
'# Tencent Cloud TokenHub' H1 (Mintlify renders title from frontmatter;
the in-body H1 produces a brittle anchor). Added a properties summary
with onboarding flag and direct CLI flag. Promoted the Quick Start
auth step into a CodeGroup covering onboarding/direct/env. Added a
tiered-pricing table sourced from the bundled cost.tieredPricing
metadata so cost expectations are visible alongside the catalog.
Replaced trailing bullet list under 'Related documentation' with a
CardGroup pointing at TokenHub product/model-card pages.

Mistral (docs/providers/mistral.md): replaced the 3-bullet provider
header with a properties table that surfaces all four contracts the
plugin registers (chat completions via the model catalog, media
understanding Voxtral batch, voice-call streaming Voxtral Realtime, and
memory embeddings via mistral-embed) plus the onboarding flag and
direct CLI flag. Removed a stray 'Z.AI uses Bearer auth' line that had
leaked into the 'Auth and base URL' accordion from a copy-paste
elsewhere; replaced it with a Mistral-correct base-URL override note.
Verified the seven-row LLM catalog matches plugin manifest model ids.

Inferrs (docs/providers/inferrs.md): added a properties table
explicitly stating that inferrs is NOT a bundled plugin and is
configured under models.providers.inferrs (no onboarding choice flag,
no extension package). Cross-linked SGLang and vLLM as bundled
self-hosted alternatives so readers picking a local backend can
compare.

2026-05-05 17:24:53 -07:00

5.2 KiB

Raw Permalink 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

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

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.

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

OpenClaw defaults to Tencent Cloud's `https://tokenhub.tencentmaas.com/v1` endpoint. Tencent also documents an international TokenHub endpoint:

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

<Warning>
  Keys set only in `~/.profile` 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.2 KiB Raw Permalink Blame History