diff --git a/docs/start/onboarding-overview.md b/docs/start/onboarding-overview.md
index a5be3adc4813..5c7b39a186fb 100644
--- a/docs/start/onboarding-overview.md
+++ b/docs/start/onboarding-overview.md
@@ -16,13 +16,13 @@ detailed setup.
 
 ## Which path should I use?
 
-|                | CLI onboarding                         | macOS app onboarding           |
-| -------------- | -------------------------------------- | ------------------------------ |
-| **Platforms**  | macOS, Linux, Windows (native or WSL2) | macOS only                     |
-| **Interface**  | Inference setup, then OpenClaw         | Inference setup, then OpenClaw |
-| **Best for**   | Servers, headless, full control        | Desktop Mac, visual setup      |
-| **Automation** | `--non-interactive` for scripts        | Manual only                    |
-| **Command**    | `openclaw onboard`                     | Launch the app                 |
+|                | CLI onboarding                         | macOS app onboarding                                          |
+| -------------- | -------------------------------------- | ------------------------------------------------------------- |
+| **Platforms**  | macOS, Linux, Windows (native or WSL2) | macOS only                                                    |
+| **Interface**  | Inference setup, then OpenClaw         | Inference setup, then OpenClaw                                |
+| **Best for**   | Servers, headless, full control        | Desktop Mac, visual setup                                     |
+| **Automation** | `--non-interactive` for scripts        | Manual only                                                   |
+| **Command**    | `openclaw onboard`                     | [Download the app](/platforms/macos#download), then launch it |
 
 Most users should start with **CLI onboarding** — it works everywhere and gives
 you the most control.
@@ -81,7 +81,8 @@ CLI command docs: [`openclaw onboard`](/cli/onboard)
 
 ## macOS app onboarding
 
-Open the OpenClaw app. If its configured local or remote Gateway is reachable
+[Download the macOS app](/platforms/macos#download), then open it. If its
+configured local or remote Gateway is reachable
 and the default agent already has a configured model, the app skips onboarding
 and OpenClaw and opens the normal agent UI immediately.
 
diff --git a/docs/start/onboarding.md b/docs/start/onboarding.md
index dd73c735b818..baa91b1ab5a9 100644
--- a/docs/start/onboarding.md
+++ b/docs/start/onboarding.md
@@ -12,6 +12,11 @@ verified AI backend, grant permissions, and hand off to the agent's own
 bootstrap ritual.
 For CLI onboarding and a comparison of both paths, see [Onboarding Overview](/start/onboarding-overview).
 
+<Tip>
+Need the app first? [Download OpenClaw for macOS](/platforms/macos#download),
+then return here for first-run setup.
+</Tip>
+
 <Steps>
 <Step title="Approve macOS warning">
 <Frame>