mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-12 09:40:41 +00:00
813fe0a3be
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.
131 lines
5.2 KiB
Markdown
131 lines
5.2 KiB
Markdown
---
|
|
summary: "Tencent Cloud TokenHub setup for Hy3 preview"
|
|
title: "Tencent Cloud (TokenHub)"
|
|
read_when:
|
|
- 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
|
|
|
|
<Steps>
|
|
<Step title="Create a TokenHub API key">
|
|
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.
|
|
</Step>
|
|
<Step title="Run onboarding">
|
|
<CodeGroup>
|
|
|
|
```bash Onboarding
|
|
openclaw onboard --auth-choice tokenhub-api-key
|
|
```
|
|
|
|
```bash Direct flag
|
|
openclaw onboard --non-interactive \
|
|
--auth-choice tokenhub-api-key \
|
|
--tokenhub-api-key "$TOKENHUB_API_KEY"
|
|
```
|
|
|
|
```bash Env only
|
|
export TOKENHUB_API_KEY=...
|
|
```
|
|
|
|
</CodeGroup>
|
|
|
|
</Step>
|
|
<Step title="Verify the model">
|
|
```bash
|
|
openclaw models list --provider tencent-tokenhub
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Non-interactive setup
|
|
|
|
```bash
|
|
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`.
|
|
|
|
<Tip>
|
|
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.
|
|
</Tip>
|
|
|
|
## 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
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Endpoint override">
|
|
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.
|
|
|
|
</Accordion>
|
|
|
|
<Accordion title="Environment availability for the daemon">
|
|
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>
|
|
|
|
</Accordion>
|
|
</AccordionGroup>
|
|
|
|
## Related
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Model providers" href="/concepts/model-providers" icon="layers">
|
|
Choosing providers, model refs, and failover behavior.
|
|
</Card>
|
|
<Card title="Configuration reference" href="/gateway/configuration" icon="gear">
|
|
Full config schema including provider settings.
|
|
</Card>
|
|
<Card title="Tencent TokenHub" href="https://cloud.tencent.com/product/tokenhub" icon="arrow-up-right-from-square">
|
|
Tencent Cloud's TokenHub product page.
|
|
</Card>
|
|
<Card title="Hy3 preview model card" href="https://huggingface.co/tencent/Hy3-preview" icon="square-poll-horizontal">
|
|
Tencent Hunyuan Hy3 preview details and benchmarks.
|
|
</Card>
|
|
</CardGroup>
|