mirror of https://github.com/openclaw/openclaw.git synced 2026-02-16 23:29:32 +00:00

Files

Blossom c0befdee0b feat(onboard): add custom/local API configuration flow (#11106 )

* feat(onboard): add custom/local API configuration flow

* ci: retry macos check

* fix: expand custom API onboarding (#11106) (thanks @MackDing)

* fix: refine custom endpoint detection (#11106) (thanks @MackDing)

* fix: streamline custom endpoint onboarding (#11106) (thanks @MackDing)

* fix: skip model picker for custom endpoint (#11106) (thanks @MackDing)

* fix: avoid allowlist picker for custom endpoint (#11106) (thanks @MackDing)

* Onboard: reuse shared fetch timeout helper (#11106) (thanks @MackDing)

* Onboard: clarify default base URL name (#11106) (thanks @MackDing)

---------

Co-authored-by: OpenClaw Contributor <contributor@openclaw.ai>
Co-authored-by: Gustavo Madeira Santana <gumadeiras@gmail.com>

2026-02-10 07:31:02 -05:00

2.6 KiB

Raw Permalink Blame History

summary, read_when, title, sidebarTitle

summary

read_when

title

sidebarTitle

First-run onboarding flow for OpenClaw (macOS app)

Designing the macOS onboarding assistant

Implementing auth or identity setup

Onboarding (macOS App)

Onboarding: macOS App

Onboarding (macOS App)

This doc describes the current first‑run onboarding flow. The goal is a smooth “day 0” experience: pick where the Gateway runs, connect auth, run the wizard, and let the agent bootstrap itself. For a general overview of onboarding paths, see Onboarding Overview.

Where does the Gateway run?

This Mac (Local only): onboarding can run OAuth flows and write credentials locally.
Remote (over SSH/Tailnet): onboarding does not run OAuth locally; credentials must exist on the gateway host.
Configure later: skip setup and leave the app unconfigured.

**Gateway auth tip:** - The wizard now generates a **token** even for loopback, so local WS clients must authenticate. - If you disable auth, any local process can connect; use that only on fully trusted machines. - Use a **token** for multi‑machine access or non‑loopback binds.

Onboarding requests TCC permissions needed for:

Automation (AppleScript)
Notifications
Accessibility
Screen Recording
Microphone
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.

2.6 KiB Raw Permalink Blame History Unescape Escape

Onboarding (macOS App)

2.6 KiB

Raw Permalink Blame History