> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wednesdayai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.wednesdayai.dev/next/users/start/onboarding-overview.md).

**1. Approve macOS warning**

![](https://mintcdn.com/expansionxpartners/zs8LxhdBvaZG5WAK/media/e7b3a4b37bba-01-macos-warning.jpeg?fit=max\&auto=format\&n=zs8LxhdBvaZG5WAK\&q=85\&s=d3f58f317bc16da93f162d4fcc4246f5)

**2. Approve find local networks**

![](https://mintcdn.com/expansionxpartners/zs8LxhdBvaZG5WAK/media/71d220843a71-02-local-networks.jpeg?fit=max\&auto=format\&n=zs8LxhdBvaZG5WAK\&q=85\&s=a4571fb1c1f25f63f25180442e0e06ee)

**3. Welcome and security notice**

![](https://mintcdn.com/expansionxpartners/zs8LxhdBvaZG5WAK/media/8ba598219f5c-03-security-notice.png?fit=max\&auto=format\&n=zs8LxhdBvaZG5WAK\&q=85\&s=5d1bda79f25963eefcfdb76630688600)

Read the security notice displayed and decide accordingly

Security trust model:

* By default, WednesdayAI is a personal agent: one trusted operator boundary.
* Shared/multi-user setups require lock-down (split trust boundaries, keep tool access minimal, and follow [Security](https://docs.wednesdayai.dev/next/admin/gateway/security.md)).
* Local onboarding now defaults new configs to `tools.profile: "messaging"` so broad runtime/filesystem tools are opt-in. New deployments (where `tools.profile` was unset) also get `tools.alsoAllow: ["group:fs"]` and `tools.fs.workspaceOnly: true`, so the agent has workspace-contained `read`/`write`/`edit`/`delete` tools for its first-run ritual. Existing configs with an explicit profile are left alone; opt in with `tools.alsoAllow: ["group:fs"]` plus `tools.fs.workspaceOnly: true`.
* If hooks/webhooks or other untrusted content feeds are enabled, use a strong modern model tier and keep strict tool policy/sandboxing.

**4. Local vs Remote**

![](https://mintcdn.com/expansionxpartners/zs8LxhdBvaZG5WAK/media/9864c8d35ad0-04-choose-gateway.png?fit=max\&auto=format\&n=zs8LxhdBvaZG5WAK\&q=85\&s=f796a0ce963d176bd2a23eb315ba93c2)

Where does the **Gateway** run?

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

> [!TIP]
>
> **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.

**5. Permissions**

![](https://mintcdn.com/expansionxpartners/zs8LxhdBvaZG5WAK/media/571c5ba9131d-05-permissions.png?fit=max\&auto=format\&n=zs8LxhdBvaZG5WAK\&q=85\&s=31ffb788aa35e356329739dc4ba52413)

Choose what permissions do you want to give OpenClaw

Onboarding requests TCC permissions needed for:

* Automation (AppleScript)
* Notifications
* Accessibility
* Screen Recording
* Microphone
* Speech Recognition
* Camera
* Location

**6. CLI**

\[!NOTE] 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.

**7. Onboarding Chat (dedicated session)**

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](https://docs.wednesdayai.dev/next/users/start/bootstrapping.md) for
what happens on the gateway host during the first agent run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.