First steps
Introductie (macOS-app)
Dit document beschrijft de huidige setupflow bij de eerste start. Het doel is een soepele "dag 0"-ervaring: kies waar de Gateway draait, koppel authenticatie, doorloop de wizard en laat de agent zichzelf bootstrappen. Zie Onboarding-overzicht voor een algemeen overzicht van onboardingpaden.
macOS-waarschuwing goedkeuren
Lokale netwerken zoeken goedkeuren
Welkom en beveiligingsmelding
Beveiligingsvertrouwensmodel:
- Standaard is OpenClaw een persoonlijke agent: één vertrouwde operatorgrens.
- Gedeelde/multi-user setups vereisen vergrendeling (splits vertrouwensgrenzen, houd tooltoegang minimaal en volg Beveiliging).
- Lokale onboarding stelt nieuwe configuraties nu standaard in op
tools.profile: "coding", zodat nieuwe lokale setups filesystem-/runtime-tools behouden zonder het onbeperkte profielfullaf te dwingen. - Als hooks/Webhooks of andere niet-vertrouwde contentfeeds zijn ingeschakeld, gebruik dan een sterk modern modelniveau en hanteer strikt toolbeleid/sandboxing.
Lokaal versus extern
Waar draait de Gateway?
- Deze Mac (alleen lokaal): onboarding kan authenticatie configureren en referenties lokaal wegschrijven.
- Extern (via SSH/Tailnet): onboarding configureert geen lokale authenticatie; referenties moeten op de gatewayhost bestaan.
- Later configureren: sla de setup over en laat de app ongeconfigureerd.
Machtigingen
Onboarding vraagt TCC-machtigingen aan die nodig zijn voor:
- Automatisering (AppleScript)
- Meldingen
- Toegankelijkheid
- Schermopname
- Microfoon
- Spraakherkenning
- Camera
- Locatie
CLI
Onboardingchat (speciale sessie)
Na de setup opent de app een speciale onboardingchatsessie, zodat de agent zichzelf kan introduceren en de volgende stappen kan begeleiden. Zo blijft begeleiding bij de eerste start gescheiden van je normale gesprek. Zie Bootstrapping voor wat er op de gatewayhost gebeurt tijdens de eerste agentrun.