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.

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.

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.

Onboarding vraagt TCC-rechten aan die nodig zijn voor:

• Automatisering (AppleScript)
• Meldingen
• Toegankelijkheid
• Schermopname
• Microfoon
• Spraakherkenning
• Camera
• Locatie

Deze stap is optioneel De app kan de globale openclaw CLI via npm/pnpm installeren zodat terminal‑ workflows en launchd‑taken direct werken. 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 voor wat er gebeurt op de Gateway-host tijdens de eerste agentrun.