@@ -1,24 +1,45 @@
11---
22title: "Tencent Cloud (TokenHub)"
3-summary: "Tencent Cloud TokenHub setup"
3+summary: "Tencent Cloud TokenHub setup for Hy3 preview"
44read_when:
5- - You want to use Tencent Hy models with OpenClaw
5+ - You want to use Tencent Hy3 preview with OpenClaw
66 - You need the TokenHub API key setup
77---
889-# Tencent Cloud (TokenHub)
9+# Tencent Cloud TokenHub
101011-Tencent Cloud ships as a **bundled provider plugin** in OpenClaw. It gives access to Tencent Hy models via the TokenHub endpoint (`tencent-tokenhub`).
11+Tencent Cloud ships as a **bundled provider plugin** in OpenClaw. It gives access to Tencent Hy3 preview through the TokenHub endpoint (`tencent-tokenhub`).
12121313The provider uses an OpenAI-compatible API.
141415-## Quick start
15+| Property | Value |
16+| ------------- | ------------------------------------------ |
17+| Provider | `tencent-tokenhub` |
18+| Default model | `tencent-tokenhub/hy3-preview` |
19+| Auth | `TOKENHUB_API_KEY` |
20+| API | OpenAI-compatible chat completions |
21+| Base URL | `https://tokenhub.tencentmaas.com/v1` |
22+| Global URL | `https://tokenhub-intl.tencentmaas.com/v1` |
162317-```bash
18-openclaw onboard --auth-choice tokenhub-api-key
19-```
24+## Quick start
202521-## Non-interactive example
26+<Steps>
27+<Step title="Create a TokenHub API key">
28+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.
29+</Step>
30+<Step title="Run onboarding">
31+```bash
32+openclaw onboard --auth-choice tokenhub-api-key
33+```
34+</Step>
35+<Step title="Verify the model">
36+```bash
37+openclaw models list --provider tencent-tokenhub
38+```
39+</Step>
40+</Steps>
41+42+## Non-interactive setup
22432344```bash
2445openclaw onboard --non-interactive \
@@ -29,23 +50,35 @@ openclaw onboard --non-interactive \
2950 --accept-risk
3051```
315232-## Providers and endpoints
53+## Model catalog
54+55+| Model ref | Name | Input | Context | Max output | Notes |
56+| ------------------------------ | ---------------------- | ----- | ------- | ---------- | -------------------------- |
57+| `tencent-tokenhub/hy3-preview` | Hy3 preview (TokenHub) | text | 256,000 | 64,000 | Default; reasoning-enabled |
335834-| Provider | Endpoint | Use case |
35-| ------------------ | ----------------------------- | ----------------------- |
36-| `tencent-tokenhub` | `tokenhub.tencentmaas.com/v1` | Hy via Tencent TokenHub |
59+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`.
376038-## Available models
61+<Tip>
62+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.
63+</Tip>
396440-### tencent-tokenhub
65+## Endpoint override
66+67+OpenClaw defaults to Tencent Cloud's `https://tokenhub.tencentmaas.com/v1` endpoint. Tencent also documents an international TokenHub endpoint:
68+69+```bash
70+openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
71+```
417242-- **hy3-preview** — Hy3 preview (256K context, reasoning, default)
73+Only override the endpoint when your TokenHub account or region requires it.
43744475## Notes
45764677- TokenHub model refs use `tencent-tokenhub/<modelId>`.
47-- The plugin ships with tiered Hy3 pricing metadata built in, so cost estimates are populated without manual pricing overrides.
48-- Override pricing and context metadata in `models.providers` if needed.
78+- The bundled catalog currently includes `hy3-preview`.
79+- The plugin marks Hy3 preview as reasoning-capable and streaming-usage capable.
80+- The plugin ships with tiered Hy3 pricing metadata, so cost estimates are populated without manual pricing overrides.
81+- Override pricing, context, or endpoint metadata in `models.providers` only when needed.
49825083## Environment note
5184@@ -57,4 +90,7 @@ is available to that process (for example, in `~/.openclaw/.env` or via
57905891- [OpenClaw Configuration](/gateway/configuration)
5992- [Model Providers](/concepts/model-providers)
60-- [Tencent TokenHub](https://cloud.tencent.com/document/product/1823/130050)
93+- [Tencent TokenHub product page](https://cloud.tencent.com/product/tokenhub)
94+- [Tencent TokenHub text generation](https://cloud.tencent.com/document/product/1823/130079)
95+- [Tencent TokenHub Cline setup for Hy3 preview](https://cloud.tencent.com/document/product/1823/130932)
96+- [Tencent Hy3 preview model card](https://huggingface.co/tencent/Hy3-preview)
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。