Zum Hauptinhalt springen

​
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.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

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.
5

Permissions

Das Onboarding fordert die benötigten TCC-Berechtigungen an für:
  • Automation (AppleScript)
  • Mitteilungen
  • Bedienungshilfen
  • Bildschirmaufnahme
  • Mikrofon
  • Spracherkennung
  • Kamera
  • Standort
6

CLI

Dieser Schritt ist optional
Die App kann die globale openclaw CLI über npm/pnpm installieren, sodass Terminal‑Workflows und launchd‑Tasks sofort funktionieren.
7

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 für Informationen dazu, was beim ersten Agentenlauf auf dem Gateway-Host passiert.