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. For a general overview of onboarding paths, see Onboarding Overview.

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.

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.

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

• Automation (AppleScript)
• Mitteilungen
• Bedienungshilfen
• Bildschirmaufnahme
• Mikrofon
• Spracherkennung
• Kamera
• Standort

Dieser Schritt ist optional Die App kann die globale openclaw CLI über npm/pnpm installieren, sodass Terminal‑Workflows und launchd‑Tasks sofort funktionieren. 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 für Informationen dazu, was beim ersten Agentenlauf auf dem Gateway-Host passiert.