@@ -6,20 +6,19 @@ read_when:
66 - You need the TokenHub API key setup
77---
889-# Tencent Cloud TokenHub
10-11-Tencent Cloud ships as a **bundled provider plugin** in OpenClaw. It gives access to Tencent Hy3 preview through the TokenHub endpoint (`tencent-tokenhub`).
12-13-The provider uses an OpenAI-compatible API.
14-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` |
9+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.
10+11+| Property | Value |
12+| ---------------- | ----------------------------------------------------- |
13+| Provider id | `tencent-tokenhub` |
14+| Plugin | bundled, `enabledByDefault: true` |
15+| Auth env var | `TOKENHUB_API_KEY` |
16+| Onboarding flag | `--auth-choice tokenhub-api-key` |
17+| Direct CLI flag | `--tokenhub-api-key <key>` |
18+| API | OpenAI-compatible (`openai-completions`) |
19+| Default base URL | `https://tokenhub.tencentmaas.com/v1` |
20+| Global base URL | `https://tokenhub-intl.tencentmaas.com/v1` (override) |
21+| Default model | `tencent-tokenhub/hy3-preview` |
23222423## Quick start
2524@@ -28,9 +27,24 @@ The provider uses an OpenAI-compatible API.
2827Create an API key in Tencent Cloud TokenHub. If you choose a limited access scope for the key, include **Hy3 preview** in the allowed models.
2928</Step>
3029<Step title="Run onboarding">
31-```bash
32-openclaw onboard --auth-choice tokenhub-api-key
33-```
30+<CodeGroup>
31+32+```bash Onboarding
33+openclaw onboard --auth-choice tokenhub-api-key
34+```
35+36+```bash Direct flag
37+openclaw onboard --non-interactive \
38+ --auth-choice tokenhub-api-key \
39+ --tokenhub-api-key "$TOKENHUB_API_KEY"
40+```
41+42+```bash Env only
43+export TOKENHUB_API_KEY=...
44+```
45+46+</CodeGroup>
47+3448</Step>
3549<Step title="Verify the model">
3650```bash
@@ -59,38 +73,58 @@ openclaw onboard --non-interactive \
5973Hy3 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`.
60746175<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.
76+ 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.
6377</Tip>
647865-## Endpoint override
79+## Tiered pricing
668067-OpenClaw defaults to Tencent Cloud's `https://tokenhub.tencentmaas.com/v1` endpoint. Tencent also documents an international TokenHub endpoint:
81+The bundled catalog ships tiered cost metadata that scales with input window length, so cost estimates are populated without manual overrides.
688269-```bash
70-openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
71-```
83+| Input tokens range | Input rate | Output rate | Cache read |
84+| ------------------ | ---------- | ----------- | ---------- |
85+| 0 - 16,000 | 0.176 | 0.587 | 0.059 |
86+| 16,000 - 32,000 | 0.235 | 0.939 | 0.088 |
87+| 32,000+ | 0.293 | 1.173 | 0.117 |
88+89+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.
90+91+## Advanced configuration
92+93+<AccordionGroup>
94+<Accordion title="Endpoint override">
95+OpenClaw defaults to Tencent Cloud's `https://tokenhub.tencentmaas.com/v1` endpoint. Tencent also documents an international TokenHub endpoint:
96+97+```bash
98+openclaw config set models.providers.tencent-tokenhub.baseUrl "https://tokenhub-intl.tencentmaas.com/v1"
99+```
7210073-Only override the endpoint when your TokenHub account or region requires it.
101+ Only override the endpoint when your TokenHub account or region requires it.
7410275-## Notes
103+ </Accordion>
7610477-- TokenHub model refs use `tencent-tokenhub/<modelId>`.
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.
105+<Accordion title="Environment availability for the daemon">
106+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.
8210783-## Environment note
108+<Warning>
109+ Keys set only in `~/.profile` are not visible to managed gateway processes. Use the env file or config seam for persistent availability.
110+</Warning>
8411185-If the Gateway runs as a daemon (launchd/systemd), make sure `TOKENHUB_API_KEY`
86-is available to that process (for example, in `~/.openclaw/.env` or via
87-`env.shellEnv`).
112+</Accordion>
113+</AccordionGroup>
8811489-## Related documentation
115+## Related
9011691-- [OpenClaw Configuration](/gateway/configuration)
92-- [Model Providers](/concepts/model-providers)
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)
117+<CardGroup cols={2}>
118+<Card title="Model providers" href="/concepts/model-providers" icon="layers">
119+Choosing providers, model refs, and failover behavior.
120+</Card>
121+<Card title="Configuration reference" href="/gateway/configuration" icon="gear">
122+Full config schema including provider settings.
123+</Card>
124+<Card title="Tencent TokenHub" href="https://cloud.tencent.com/product/tokenhub" icon="arrow-up-right-from-square">
125+Tencent Cloud's TokenHub product page.
126+</Card>
127+<Card title="Hy3 preview model card" href="https://huggingface.co/tencent/Hy3-preview" icon="square-poll-horizontal">
128+Tencent Hunyuan Hy3 preview details and benchmarks.
129+</Card>
130+</CardGroup>
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。