diff --git a/docs/start/onboarding.md b/docs/start/onboarding.md
index 32a28d7c5..be8b9713c 100644
--- a/docs/start/onboarding.md
+++ b/docs/start/onboarding.md
@@ -64,16 +64,17 @@ Onboarding requests TCC permissions needed for:
- Speech Recognition
- Camera
- Location
-
-
+
+
+
This step is optional
The app can install the global `openclaw` CLI via npm/pnpm so terminal
workflows and launchd tasks work out of the box.
-
-
+
+
After setup, the app opens a dedicated onboarding chat session so the agent can
introduce itself and guide next steps. This keeps first‑run guidance separate
from your normal conversation. See [Bootstrapping](/start/bootstrapping) for
what happens on the gateway host during the first agent run.
-
-
+
+