diff --git a/docs/providers/tencent.md b/docs/providers/tencent.md
index b1955764b5b..2cf325648f3 100644
--- a/docs/providers/tencent.md
+++ b/docs/providers/tencent.md
@@ -1,24 +1,45 @@
 ---
 title: "Tencent Cloud (TokenHub)"
-summary: "Tencent Cloud TokenHub setup"
+summary: "Tencent Cloud TokenHub setup for Hy3 preview"
 read_when:
-  - You want to use Tencent Hy models with OpenClaw
+  - You want to use Tencent Hy3 preview with OpenClaw
   - You need the TokenHub API key setup
 ---
 
-# Tencent Cloud (TokenHub)
+# Tencent Cloud TokenHub
 
-Tencent Cloud ships as a **bundled provider plugin** in OpenClaw. It gives access to Tencent Hy models via the TokenHub endpoint (`tencent-tokenhub`).
+Tencent Cloud ships as a **bundled provider plugin** in OpenClaw. It gives access to Tencent Hy3 preview through the TokenHub endpoint (`tencent-tokenhub`).
 
 The provider uses an OpenAI-compatible API.
 
+| Property      | Value                                      |
+| ------------- | ------------------------------------------ |
+| Provider      | `tencent-tokenhub`                         |
+| Default model | `tencent-tokenhub/hy3-preview`             |
+| Auth          | `TOKENHUB_API_KEY`                         |
+| API           | OpenAI-compatible chat completions         |
+| Base URL      | `https://tokenhub.tencentmaas.com/v1`      |
+| Global URL    | `https://tokenhub-intl.tencentmaas.com/v1` |
+
 ## Quick start
 
-```bash
-openclaw onboard --auth-choice tokenhub-api-key
-```
+<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">
+    ```bash
+    openclaw onboard --auth-choice tokenhub-api-key
+    ```
+  </Step>
+  <Step title="Verify the model">
+    ```bash
+    openclaw models list --provider tencent-tokenhub
+    ```
+  </Step>
+</Steps>
 
-## Non-interactive example
+## Non-interactive setup
 
 ```bash
 openclaw onboard --non-interactive \
@@ -29,23 +50,35 @@ openclaw onboard --non-interactive \
   --accept-risk
 ```
 
-## Providers and endpoints
+## Model catalog
 
-| Provider           | Endpoint                      | Use case                |
-| ------------------ | ----------------------------- | ----------------------- |
-| `tencent-tokenhub` | `tokenhub.tencentmaas.com/v1` | Hy via Tencent TokenHub |
+| Model ref                      | Name                   | Input | Context | Max output | Notes                      |
+| ------------------------------ | ---------------------- | ----- | ------- | ---------- | -------------------------- |
+| `tencent-tokenhub/hy3-preview` | Hy3 preview (TokenHub) | text  | 256,000 | 64,000     | Default; reasoning-enabled |
 
-## Available models
+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`.
 
-### tencent-tokenhub
+<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>
 
-- **hy3-preview** — Hy3 preview (256K context, reasoning, default)
+## 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.
 
 ## Notes
 
 - TokenHub model refs use `tencent-tokenhub/<modelId>`.
-- The plugin ships with tiered Hy3 pricing metadata built in, so cost estimates are populated without manual pricing overrides.
-- Override pricing and context metadata in `models.providers` if needed.
+- The bundled catalog currently includes `hy3-preview`.
+- The plugin marks Hy3 preview as reasoning-capable and streaming-usage capable.
+- The plugin ships with tiered Hy3 pricing metadata, so cost estimates are populated without manual pricing overrides.
+- Override pricing, context, or endpoint metadata in `models.providers` only when needed.
 
 ## Environment note
 
@@ -57,4 +90,7 @@ is available to that process (for example, in `~/.openclaw/.env` or via
 
 - [OpenClaw Configuration](/gateway/configuration)
 - [Model Providers](/concepts/model-providers)
-- [Tencent TokenHub](https://cloud.tencent.com/document/product/1823/130050)
+- [Tencent TokenHub product page](https://cloud.tencent.com/product/tokenhub)
+- [Tencent TokenHub text generation](https://cloud.tencent.com/document/product/1823/130079)
+- [Tencent TokenHub Cline setup for Hy3 preview](https://cloud.tencent.com/document/product/1823/130932)
+- [Tencent Hy3 preview model card](https://huggingface.co/tencent/Hy3-preview)