diff --git a/docs/cli/configure.md b/docs/cli/configure.md
index 86a4502b6bb..02ad6f9f70a 100644
--- a/docs/cli/configure.md
+++ b/docs/cli/configure.md
@@ -12,6 +12,13 @@ Interactive prompt to set up credentials, devices, and agent defaults.
 Note: The **Model** section now includes a multi-select for the
 `agents.defaults.models` allowlist (what shows up in `/model` and the model picker).
 
+When configure starts from a provider auth choice, the default-model and
+allowlist pickers prefer that provider automatically. For paired providers such
+as Volcengine/BytePlus, the same preference also matches their coding-plan
+variants (`volcengine-plan/*`, `byteplus-plan/*`). If the preferred-provider
+filter would produce an empty list, configure falls back to the unfiltered
+catalog instead of showing a blank picker.
+
 Tip: `openclaw config` without a subcommand opens the same wizard. Use
 `openclaw config get|set|unset` for non-interactive edits.
 
diff --git a/docs/cli/onboard.md b/docs/cli/onboard.md
index c49094a0d7f..c6771b36361 100644
--- a/docs/cli/onboard.md
+++ b/docs/cli/onboard.md
@@ -142,6 +142,12 @@ Flow notes:
 
 - `quickstart`: minimal prompts, auto-generates a gateway token.
 - `manual`: full prompts for port/bind/auth (alias of `advanced`).
+- When an auth choice implies a preferred provider, onboarding prefilters the
+  default-model and allowlist pickers to that provider. For Volcengine and
+  BytePlus, this also matches the coding-plan variants
+  (`volcengine-plan/*`, `byteplus-plan/*`).
+- If the preferred-provider filter yields no loaded models yet, onboarding
+  falls back to the unfiltered catalog instead of leaving the picker empty.
 - In the web-search step, some providers can trigger provider-specific
   follow-up prompts:
   - **Grok** can offer optional `x_search` setup with the same `XAI_API_KEY`
diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md
index 825b36a3ab8..c10dfc0485a 100644
--- a/docs/concepts/model-providers.md
+++ b/docs/concepts/model-providers.md
@@ -439,6 +439,11 @@ Volcano Engine (火山引擎) provides access to Doubao and other models in Chin
 Onboarding defaults to the coding surface, but the general `volcengine/*`
 catalog is registered at the same time.
 
+In onboarding/configure model pickers, the Volcengine auth choice prefers both
+`volcengine/*` and `volcengine-plan/*` rows. If those models are not loaded yet,
+OpenClaw falls back to the unfiltered catalog instead of showing an empty
+provider-scoped picker.
+
 Available models:
 
 - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8)
@@ -475,6 +480,11 @@ BytePlus ARK provides access to the same models as Volcano Engine for internatio
 Onboarding defaults to the coding surface, but the general `byteplus/*`
 catalog is registered at the same time.
 
+In onboarding/configure model pickers, the BytePlus auth choice prefers both
+`byteplus/*` and `byteplus-plan/*` rows. If those models are not loaded yet,
+OpenClaw falls back to the unfiltered catalog instead of showing an empty
+provider-scoped picker.
+
 Available models:
 
 - `byteplus/seed-1-8-251228` (Seed 1.8)
diff --git a/docs/providers/volcengine.md b/docs/providers/volcengine.md
index f61d2520525..50ff9c33a74 100644
--- a/docs/providers/volcengine.md
+++ b/docs/providers/volcengine.md
@@ -82,6 +82,11 @@ Coding provider (`volcengine-plan`):
 `volcengine-plan/ark-code-latest` as the default model while also registering
 the general `volcengine` catalog.
 
+During onboarding/configure model selection, the Volcengine auth choice prefers
+both `volcengine/*` and `volcengine-plan/*` rows. If those models are not
+loaded yet, OpenClaw falls back to the unfiltered catalog instead of showing an
+empty provider-scoped picker.
+
 ## Environment note
 
 If the Gateway runs as a daemon (launchd/systemd), make sure
diff --git a/docs/start/wizard-cli-reference.md b/docs/start/wizard-cli-reference.md
index d49a6e40628..df7271b29ea 100644
--- a/docs/start/wizard-cli-reference.md
+++ b/docs/start/wizard-cli-reference.md
@@ -223,6 +223,12 @@ What you set:
 Model behavior:
 
 - Pick default model from detected options, or enter provider and model manually.
+- When onboarding starts from a provider auth choice, the model picker prefers
+  that provider automatically. For Volcengine and BytePlus, the same preference
+  also matches their coding-plan variants (`volcengine-plan/*`,
+  `byteplus-plan/*`).
+- If that preferred-provider filter would be empty, the picker falls back to
+  the full catalog instead of showing no models.
 - Wizard runs a model check and warns if the configured model is unknown or missing auth.
 
 Credential and profile paths: