From f308af8a344a30432e1b13fa348533e54cd190c8 Mon Sep 17 00:00:00 2001 From: wangyan2026 Date: Wed, 29 Jul 2026 00:53:24 +0800 Subject: [PATCH] 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 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 --------- Co-authored-by: Peter Steinberger --- docs/start/onboarding-overview.md | 17 +++++++++-------- docs/start/onboarding.md | 5 +++++ 2 files changed, 14 insertions(+), 8 deletions(-) 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). + +Need the app first? [Download OpenClaw for macOS](/platforms/macos#download), +then return here for first-run setup. + +