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

# Onboarding (macOS‑app)

# Onboarding (macOS‑app)

Dit document beschrijft de **huidige** onboardingstroom bij de eerste start. Het doel is een
soepele “dag 0”-ervaring: kies waar de Gateway draait, verbind authenticatie, doorloop de
wizard en laat de agent zichzelf bootstrapen.
Voor een algemeen overzicht van onboardingtrajecten, zie [Onboarding Overview](/start/onboarding-overview).

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=52ce8b835daf7a29b63c3ee7f4a0308a" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Approve find local networks">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=898d91d6350aef17eb26d54f2aae7398" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Welcome and security notice">
    <Frame caption="Lees de weergegeven beveiligingsmelding en beslis dienovereenkomstig">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=f5c2f45dfb79fb3102f3b00349685c5e" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>
  </Step>

  <Step title="Local vs Remote">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=280e34bced7bf879d9b6f74a77abcda0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

    Waar draait de **Gateway**?

    * **Deze Mac (alleen lokaal):** onboarding kan OAuth‑stromen uitvoeren en inloggegevens
      lokaal wegschrijven.
    * **Op afstand (via SSH/Tailnet):** onboarding voert **geen** OAuth lokaal uit;
      inloggegevens moeten bestaan op de Gateway-host.
    * **Later configureren:** sla de installatie over en laat de app ongeconfigureerd.

    <Tip>
      **Gateway-authenticatietip:**

      * De wizard genereert nu een **token**, zelfs voor local loopback, zodat lokale WS-clients zich moeten authenticeren.
      * Als je authenticatie uitschakelt, kan elk lokaal proces verbinding maken; gebruik dit alleen op volledig vertrouwde machines.
      * Gebruik een **token** voor toegang vanaf meerdere machines of niet‑loopback‑bindings.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Kies welke rechten je aan OpenClaw wilt geven">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=fe49a0e85fad11452f3ee292d78e2415" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

    Onboarding vraagt TCC-rechten aan die nodig zijn voor:

    * Automatisering (AppleScript)
    * Meldingen
    * Toegankelijkheid
    * Schermopname
    * Microfoon
    * Spraakherkenning
    * Camera
    * Locatie
  </Step>

  <Step title="CLI">
    <Info>
      Deze stap is optioneel
    </Info>

    De app kan de globale `openclaw` CLI via npm/pnpm installeren zodat terminal‑
    workflows en launchd‑taken direct werken.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    Na de installatie opent de app een speciale onboardingchat‑sessie zodat de agent zich kan
    voorstellen en de volgende stappen kan begeleiden. Dit houdt begeleiding bij de eerste start
    gescheiden van je normale gesprek. Zie [Bootstrapping](/start/bootstrapping) voor
    wat er gebeurt op de Gateway-host tijdens de eerste agentrun.
  </Step>
</Steps>