diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md
index 4b2a77f3962..48b219f2562 100644
--- a/docs/concepts/model-providers.md
+++ b/docs/concepts/model-providers.md
@@ -287,10 +287,12 @@ OpenClaw ships with the pi‑ai catalog. These providers require **no**
 
 - Provider: `kilocode`
 - Auth: `KILOCODE_API_KEY`
-- Example model: `kilocode/anthropic/claude-opus-4.6`
+- Example model: `kilocode/kilo/auto`
 - CLI: `openclaw onboard --auth-choice kilocode-api-key`
 - Base URL: `https://api.kilo.ai/api/gateway/`
-- Expanded built-in catalog includes GLM-5 Free, MiniMax M2.7 Free, GPT-5.2, Gemini 3 Pro Preview, Gemini 3 Flash Preview, Grok Code Fast 1, and Kimi K2.5.
+- Static fallback catalog ships `kilocode/kilo/auto`; live
+  `https://api.kilo.ai/api/gateway/models` discovery can expand the runtime
+  catalog further.
 
 See [/providers/kilocode](/providers/kilocode) for setup details.
 
@@ -304,23 +306,33 @@ See [/providers/kilocode](/providers/kilocode) for setup details.
   OpenAI-only request shaping (`serviceTier`, Responses `store`,
   prompt-cache hints, OpenAI reasoning-compat payloads) is not forwarded
 - Kilo Gateway: `kilocode` (`KILOCODE_API_KEY`)
-- Example model: `kilocode/anthropic/claude-opus-4.6`
+- Example model: `kilocode/kilo/auto`
 - MiniMax: `minimax` (`MINIMAX_API_KEY`)
+- Example model: `minimax/MiniMax-M2.7`
 - Moonshot: `moonshot` (`MOONSHOT_API_KEY`)
+- Example model: `moonshot/kimi-k2.5`
 - Kimi Coding: `kimi` (`KIMI_API_KEY` or `KIMICODE_API_KEY`)
+- Example model: `kimi/kimi-code`
 - Qianfan: `qianfan` (`QIANFAN_API_KEY`)
+- Example model: `qianfan/deepseek-v3.2`
 - Model Studio: `modelstudio` (`MODELSTUDIO_API_KEY`)
+- Example model: `modelstudio/qwen3.5-plus`
 - NVIDIA: `nvidia` (`NVIDIA_API_KEY`)
+- Example model: `nvidia/nvidia/llama-3.1-nemotron-70b-instruct`
 - StepFun: `stepfun` / `stepfun-plan` (`STEPFUN_API_KEY`)
 - Example models: `stepfun/step-3.5-flash`, `stepfun-plan/step-3.5-flash-2603`
 - Together: `together` (`TOGETHER_API_KEY`)
+- Example model: `together/moonshotai/Kimi-K2.5`
 - Venice: `venice` (`VENICE_API_KEY`)
 - Xiaomi: `xiaomi` (`XIAOMI_API_KEY`)
+- Example model: `xiaomi/mimo-v2-flash`
 - Vercel AI Gateway: `vercel-ai-gateway` (`AI_GATEWAY_API_KEY`)
 - Hugging Face Inference: `huggingface` (`HUGGINGFACE_HUB_TOKEN` or `HF_TOKEN`)
 - Cloudflare AI Gateway: `cloudflare-ai-gateway` (`CLOUDFLARE_AI_GATEWAY_API_KEY`)
 - Volcengine: `volcengine` (`VOLCANO_ENGINE_API_KEY`)
+- Example model: `volcengine-plan/ark-code-latest`
 - BytePlus: `byteplus` (`BYTEPLUS_API_KEY`)
+- Example model: `byteplus-plan/ark-code-latest`
 - xAI: `xai` (`XAI_API_KEY`)
 - Mistral: `mistral` (`MISTRAL_API_KEY`)
 - Example model: `mistral/mistral-large-latest`
@@ -408,17 +420,20 @@ Volcano Engine (火山引擎) provides access to Doubao and other models in Chin
 
 - Provider: `volcengine` (coding: `volcengine-plan`)
 - Auth: `VOLCANO_ENGINE_API_KEY`
-- Example model: `volcengine/doubao-seed-1-8-251228`
+- Example model: `volcengine-plan/ark-code-latest`
 - CLI: `openclaw onboard --auth-choice volcengine-api-key`
 
 ```json5
 {
   agents: {
-    defaults: { model: { primary: "volcengine/doubao-seed-1-8-251228" } },
+    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
   },
 }
 ```
 
+Onboarding defaults to the coding surface, but the general `volcengine/*`
+catalog is registered at the same time.
+
 Available models:
 
 - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8)
@@ -441,17 +456,20 @@ BytePlus ARK provides access to the same models as Volcano Engine for internatio
 
 - Provider: `byteplus` (coding: `byteplus-plan`)
 - Auth: `BYTEPLUS_API_KEY`
-- Example model: `byteplus/seed-1-8-251228`
+- Example model: `byteplus-plan/ark-code-latest`
 - CLI: `openclaw onboard --auth-choice byteplus-api-key`
 
 ```json5
 {
   agents: {
-    defaults: { model: { primary: "byteplus/seed-1-8-251228" } },
+    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
   },
 }
 ```
 
+Onboarding defaults to the coding surface, but the general `byteplus/*`
+catalog is registered at the same time.
+
 Available models:
 
 - `byteplus/seed-1-8-251228` (Seed 1.8)