@@ -11,11 +11,23 @@ Interactive onboarding for local or remote Gateway setup.
11111212## Related guides
131314-- CLI onboarding hub: [Onboarding (CLI)](/start/wizard)
15-- Onboarding overview: [Onboarding Overview](/start/onboarding-overview)
16-- CLI onboarding reference: [CLI Setup Reference](/start/wizard-cli-reference)
17-- CLI automation: [CLI Automation](/start/wizard-cli-automation)
18-- macOS onboarding: [Onboarding (macOS App)](/start/onboarding)
14+<CardGroup cols={2}>
15+<Card title="CLI onboarding hub" href="/start/wizard" icon="rocket">
16+Walkthrough of the interactive CLI flow.
17+</Card>
18+<Card title="Onboarding overview" href="/start/onboarding-overview" icon="map">
19+How OpenClaw onboarding fits together.
20+</Card>
21+<Card title="CLI setup reference" href="/start/wizard-cli-reference" icon="book">
22+Outputs, internals, and per-step behavior.
23+</Card>
24+<Card title="CLI automation" href="/start/wizard-cli-automation" icon="terminal">
25+Non-interactive flags and scripted setups.
26+</Card>
27+<Card title="macOS app onboarding" href="/start/onboarding" icon="apple">
28+Onboarding flow for the macOS menu bar app.
29+</Card>
30+</CardGroup>
19312032## Examples
2133@@ -132,10 +144,11 @@ Interactive onboarding behavior with reference mode:
132144- Onboarding performs a fast preflight validation before saving the ref.
133145- If validation fails, onboarding shows the error and lets you retry.
134146135-Non-interactive Z.AI endpoint choices:
147+### Non-interactive Z.AI endpoint choices
136148137-Note: `--auth-choice zai-api-key` now auto-detects the best Z.AI endpoint for your key (prefers the general API with `zai/glm-5.1`).
138-If you specifically want the GLM Coding Plan endpoints, pick `zai-coding-global` or `zai-coding-cn`.
149+<Note>
150+`--auth-choice zai-api-key` auto-detects the best Z.AI endpoint for your key (prefers the general API with `zai/glm-5.1`). If you specifically want the GLM Coding Plan endpoints, pick `zai-coding-global` or `zai-coding-cn`.
151+</Note>
139152140153```bash
141154# Promptless endpoint selection
@@ -157,26 +170,30 @@ openclaw onboard --non-interactive \
157170 --mistral-api-key "$MISTRAL_API_KEY"
158171```
159172160-Flow notes:
161-162-- `quickstart`: minimal prompts, auto-generates a gateway token.
163-- `manual`: full prompts for port/bind/auth (alias of `advanced`).
164-- When an auth choice implies a preferred provider, onboarding prefilters the
165- default-model and allowlist pickers to that provider. For Volcengine and
166- BytePlus, this also matches the coding-plan variants
167- (`volcengine-plan/*`, `byteplus-plan/*`).
168-- If the preferred-provider filter yields no loaded models yet, onboarding
169- falls back to the unfiltered catalog instead of leaving the picker empty.
170-- In the web-search step, some providers can trigger provider-specific
171- follow-up prompts:
172-- **Grok** can offer optional `x_search` setup with the same `XAI_API_KEY`
173- and an `x_search` model choice.
174-- **Kimi** can ask for the Moonshot API region (`api.moonshot.ai` vs
175-`api.moonshot.cn`) and the default Kimi web-search model.
176-- Local onboarding DM scope behavior: [CLI Setup Reference](/start/wizard-cli-reference#outputs-and-internals).
177-- Fastest first chat: `openclaw dashboard` (Control UI, no channel setup).
178-- Custom Provider: connect any OpenAI or Anthropic compatible endpoint,
179- including hosted providers not listed. Use Unknown to auto-detect.
173+## Flow notes
174+175+<AccordionGroup>
176+<Accordion title="Flow types">
177+- `quickstart`: minimal prompts, auto-generates a gateway token.
178+- `manual`: full prompts for port, bind, and auth (alias of `advanced`).
179+</Accordion>
180+<Accordion title="Provider prefiltering">
181+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/*`).
182+183+If the preferred-provider filter yields no loaded models yet, onboarding falls back to the unfiltered catalog instead of leaving the picker empty.
184+</Accordion>
185+<Accordion title="Web-search follow-ups">
186+Some web-search providers trigger provider-specific follow-up prompts:
187+188+- **Grok** can offer optional `x_search` setup with the same `XAI_API_KEY` and an `x_search` model choice.
189+- **Kimi** can ask for the Moonshot API region (`api.moonshot.ai` vs `api.moonshot.cn`) and the default Kimi web-search model.
190+</Accordion>
191+<Accordion title="Other behaviors">
192+- Local onboarding DM scope behavior: [CLI setup reference](/start/wizard-cli-reference#outputs-and-internals).
193+- Fastest first chat: `openclaw dashboard` (Control UI, no channel setup).
194+- Custom provider: connect any OpenAI or Anthropic compatible endpoint, including hosted providers not listed. Use Unknown to auto-detect.
195+</Accordion>
196+</AccordionGroup>
180197181198## Common follow-up commands
182199此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。