diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index eafe2206b..6f73be42c 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "89932593bb5af2d52e4d3c617108732a522645bc", - "syncedAt": "2026-04-22T04:51:16.957Z" + "sha": "d8b9be468a56e28158ed5a858640928c6d2ab994", + "syncedAt": "2026-04-22T05:00:13.988Z" } diff --git a/docs/docs.json b/docs/docs.json index e42fd3cf4..348efc1e6 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -1311,6 +1311,7 @@ "providers/sglang", "providers/stepfun", "providers/synthetic", + "providers/tencent", "providers/together", "providers/venice", "providers/vercel-ai-gateway", @@ -2694,6 +2695,7 @@ "ja-JP/providers/sglang", "ja-JP/providers/stepfun", "ja-JP/providers/synthetic", + "ja-JP/providers/tencent", "ja-JP/providers/together", "ja-JP/providers/venice", "ja-JP/providers/vercel-ai-gateway", @@ -3462,6 +3464,7 @@ "es/providers/sglang", "es/providers/stepfun", "es/providers/synthetic", + "es/providers/tencent", "es/providers/together", "es/providers/venice", "es/providers/vercel-ai-gateway", @@ -4230,6 +4233,7 @@ "pt-BR/providers/sglang", "pt-BR/providers/stepfun", "pt-BR/providers/synthetic", + "pt-BR/providers/tencent", "pt-BR/providers/together", "pt-BR/providers/venice", "pt-BR/providers/vercel-ai-gateway", @@ -4998,6 +5002,7 @@ "ko/providers/sglang", "ko/providers/stepfun", "ko/providers/synthetic", + "ko/providers/tencent", "ko/providers/together", "ko/providers/venice", "ko/providers/vercel-ai-gateway", @@ -5766,6 +5771,7 @@ "de/providers/sglang", "de/providers/stepfun", "de/providers/synthetic", + "de/providers/tencent", "de/providers/together", "de/providers/venice", "de/providers/vercel-ai-gateway", @@ -6534,6 +6540,7 @@ "fr/providers/sglang", "fr/providers/stepfun", "fr/providers/synthetic", + "fr/providers/tencent", "fr/providers/together", "fr/providers/venice", "fr/providers/vercel-ai-gateway", @@ -7302,6 +7309,7 @@ "ar/providers/sglang", "ar/providers/stepfun", "ar/providers/synthetic", + "ar/providers/tencent", "ar/providers/together", "ar/providers/venice", "ar/providers/vercel-ai-gateway", @@ -8070,6 +8078,7 @@ "it/providers/sglang", "it/providers/stepfun", "it/providers/synthetic", + "it/providers/tencent", "it/providers/together", "it/providers/venice", "it/providers/vercel-ai-gateway", @@ -8838,6 +8847,7 @@ "tr/providers/sglang", "tr/providers/stepfun", "tr/providers/synthetic", + "tr/providers/tencent", "tr/providers/together", "tr/providers/venice", "tr/providers/vercel-ai-gateway", @@ -9606,6 +9616,7 @@ "uk/providers/sglang", "uk/providers/stepfun", "uk/providers/synthetic", + "uk/providers/tencent", "uk/providers/together", "uk/providers/venice", "uk/providers/vercel-ai-gateway", @@ -10374,6 +10385,7 @@ "id/providers/sglang", "id/providers/stepfun", "id/providers/synthetic", + "id/providers/tencent", "id/providers/together", "id/providers/venice", "id/providers/vercel-ai-gateway", @@ -11142,6 +11154,7 @@ "pl/providers/sglang", "pl/providers/stepfun", "pl/providers/synthetic", + "pl/providers/tencent", "pl/providers/together", "pl/providers/venice", "pl/providers/vercel-ai-gateway", diff --git a/docs/providers/tencent.md b/docs/providers/tencent.md new file mode 100644 index 000000000..8c3ea17d3 --- /dev/null +++ b/docs/providers/tencent.md @@ -0,0 +1,90 @@ +--- +title: "Tencent Cloud (TokenHub + Token Plan)" +summary: "Tencent Cloud TokenHub and Token Plan setup (separate keys)" +read_when: + - You want to use Tencent Hy models with OpenClaw + - You need the TokenHub API key or Token Plan (LKEAP) setup +--- + +# Tencent Cloud (TokenHub + Token Plan) + +The Tencent Cloud provider gives access to Tencent Hy models via two endpoints +with separate API keys: + +- **TokenHub** (`tencent-tokenhub`) — call Hy via Tencent TokenHub Gateway +- **Token Plan** (`tencent-token-plan`) — call Hy via the LKEAP + Token Plan endpoint + +Both providers use OpenAI-compatible APIs. + +## Quick start + +TokenHub: + +```bash +openclaw onboard --auth-choice tokenhub-api-key +``` + +Token Plan: + +```bash +openclaw onboard --auth-choice tencent-token-plan-api-key +``` + +## Non-interactive example + +```bash +# TokenHub +openclaw onboard --non-interactive \ + --mode local \ + --auth-choice tokenhub-api-key \ + --tokenhub-api-key "$TOKENHUB_API_KEY" \ + --skip-health \ + --accept-risk + +# Token Plan +openclaw onboard --non-interactive \ + --mode local \ + --auth-choice tencent-token-plan-api-key \ + --tencent-token-plan-api-key "$LKEAP_API_KEY" \ + --skip-health \ + --accept-risk +``` + +## Providers and endpoints + +| Provider | Endpoint | Use case | +| -------------------- | ------------------------------------- | ----------------------- | +| `tencent-tokenhub` | `tokenhub.tencentmaas.com/v1` | Hy via Tencent TokenHub | +| `tencent-token-plan` | `api.lkeap.cloud.tencent.com/plan/v3` | Hy via LKEAP Token Plan | + +Each provider uses its own API key. Setup registers only the selected provider. + +## Available models + +### tencent-tokenhub + +- **hy3-preview** — Hy3 preview (256K context, reasoning, default) + +### tencent-token-plan + +- **hy3-preview** — Hy3 preview (256K context, reasoning, default) + +## Notes + +- TokenHub model refs use `tencent-tokenhub/`. Token Plan model refs + use `tencent-token-plan/`. +- Override pricing and context metadata in `models.providers` if needed. + +## Environment note + +If the Gateway runs as a daemon (launchd/systemd), make sure `TOKENHUB_API_KEY` +or `LKEAP_API_KEY` is available to that process (for example, in +`~/.openclaw/.env` or via `env.shellEnv`). + +## Related documentation + +- [OpenClaw Configuration](/configuration) +- [Model Providers](/concepts/model-providers) +- [Tencent TokenHub](https://cloud.tencent.com/document/product/1823/130050) +- [Tencent Token Plan API](https://cloud.tencent.com/document/product/1823/130060)