> ## 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)

Dieses Dokument beschreibt den **aktuellen** Onboarding-Ablauf beim ersten Start. Ziel ist ein
reibungsloses „Tag‑0“-Erlebnis: auswählen, wo der Gateway läuft, Authentifizierung verbinden, den
Assistenten ausführen und den Agenten sich selbst bootstrappen lassen.
Einen allgemeinen Überblick über die Onboarding-Pfade findest du unter [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="Lesen Sie den angezeigten Sicherheitshinweis und entscheiden Sie entsprechend">
      <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>

    Wo läuft der **Gateway**?

    * **Dieser Mac (nur lokal):** Das Onboarding kann OAuth-Flows ausführen und Anmeldedaten
      lokal schreiben.
    * **Remote (über SSH/Tailnet):** Das Onboarding führt **keine** OAuth-Flows lokal aus;
      Anmeldedaten müssen auf dem Gateway-Host vorhanden sein.
    * **Später konfigurieren:** Einrichtung überspringen und die App unkonfiguriert lassen.

    <Tip>
      **Gateway-Auth-Tipp:**

      * Der Assistent erzeugt jetzt auch für loopback ein **Token**, sodass lokale WS-Clients sich authentifizieren müssen.
      * Wenn Sie die Authentifizierung deaktivieren, kann sich jeder lokale Prozess verbinden; nutzen Sie dies nur auf vollständig vertrauenswürdigen Maschinen.
      * Verwenden Sie ein **Token** für den Zugriff über mehrere Maschinen oder für Non‑loopback‑Bindings.
    </Tip>
  </Step>

  <Step title="Permissions">
    <Frame caption="Wählen Sie, welche Berechtigungen Sie OpenClaw erteilen möchten">
      <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>

    Das Onboarding fordert die benötigten TCC-Berechtigungen an für:

    * Automation (AppleScript)
    * Mitteilungen
    * Bedienungshilfen
    * Bildschirmaufnahme
    * Mikrofon
    * Spracherkennung
    * Kamera
    * Standort
  </Step>

  <Step title="CLI">
    <Info>
      Dieser Schritt ist optional
    </Info>

    Die App kann die globale `openclaw` CLI über npm/pnpm installieren, sodass Terminal‑Workflows
    und launchd‑Tasks sofort funktionieren.
  </Step>

  <Step title="Onboarding Chat (dedicated session)">
    Nach der Einrichtung öffnet die App eine dedizierte Onboarding-Chat-Sitzung, damit der Agent sich
    vorstellen und die nächsten Schritte anleiten kann. Dadurch bleibt die Anleitung beim ersten Start
    von Ihrer normalen Unterhaltung getrennt. Siehe [Bootstrapping](/start/bootstrapping) für
    Informationen dazu, was beim ersten Agentenlauf auf dem Gateway-Host passiert.
  </Step>
</Steps>