docs: link macOS onboarding pages to app download (#111361)

* docs: link macOS onboarding pages to app download

Add download handoff to both macOS app onboarding entry points so
first-time users can reach the app before following first-run steps.

- onboarding.md: add <Tip> linking to /platforms/macos#download
- onboarding-overview.md: update comparison table Command row and
  macOS section opening sentence with download link

Closes #111338

* docs: tighten macOS download handoff

Co-authored-by: WangYan <wang.yan29@xydigit.com>

---------

Co-authored-by: Peter Steinberger <steipete@gmail.com>
This commit is contained in:
wangyan2026
2026-07-29 00:53:24 +08:00
committed by GitHub
parent 970b2d257b
commit f308af8a34
2 changed files with 14 additions and 8 deletions
+9 -8
View File
@@ -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.
+5
View File
@@ -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>