First steps
Onboarding (macOS-app)
De eerste-startflow van de macOS-app: kies waar de Gateway draait, verbind een geverifieerde AI-backend, verleen machtigingen en draag de besturing over aan het eigen bootstrapritueel van de agent. Zie Overzicht van onboarding voor onboarding via de CLI en een vergelijking van beide trajecten.
macOS-waarschuwing goedkeuren
Zoeken naar lokale netwerken goedkeuren
Welkom en beveiligingsmelding
Vertrouwensmodel voor beveiliging:
- OpenClaw is standaard een persoonlijke agent: één grens met één vertrouwde beheerder.
- Gedeelde configuraties en configuraties voor meerdere gebruikers moeten worden vergrendeld: scheid vertrouwensgrenzen, beperk toegang tot hulpmiddelen tot een minimum en volg Beveiliging.
- Bij lokale onboarding wordt voor nieuwe configuraties standaard
tools.profile: "coding"ingesteld, zodat nieuwe configuraties toegang tot bestands- en runtimehulpmiddelen behouden zonder het onbeperkte profielfull. - Als hooks/webhooks of andere bronnen met niet-vertrouwde inhoud zijn ingeschakeld, gebruik dan een krachtig modern modelniveau en hanteer een strikt hulpmiddelenbeleid en strikte sandboxing.
Lokaal versus extern
Waar draait de Gateway?
- Deze Mac (alleen lokaal): de onboarding configureert authenticatie en schrijft de aanmeldgegevens lokaal weg.
- Extern (via SSH/Tailnet): de onboarding configureert geen lokale authenticatie;
de aanmeldgegevens moeten al op de Gateway-host aanwezig zijn. In het veld voor het externe Gateway-token
wordt het token opgeslagen waarmee de macOS-app verbinding maakt met die Gateway;
bestaande SecretRef-waarden voor
gateway.remote.tokenblijven behouden totdat u ze vervangt. - Later configureren: sla de configuratie over en laat de app ongeconfigureerd.
CLI
De lokale configuratie installeert de algemene openclaw-CLI via npm, pnpm of bun,
waarbij npm de voorkeur heeft. Node blijft de aanbevolen runtime voor de Gateway
zelf. Bestaande compatibele installaties worden hergebruikt.
Verbind uw AI
Een verbonden Gateway waarop al een agentmodel is geconfigureerd, slaat deze pagina volledig over en opent de normale agentinterface. De configuratie van Crestodian en de provider wordt alleen uitgevoerd voor een nieuwe of onvolledig geconfigureerde Gateway.
Zodra de Gateway gereed is, zoekt de onboarding naar AI-toegang die u al hebt:
een aanmelding bij Claude Code of Codex, of OPENAI_API_KEY /
ANTHROPIC_API_KEY. De beste optie wordt getest met een echte voltooiing en
pas opgeslagen nadat deze antwoord geeft; wanneer een test mislukt, probeert
de app automatisch de volgende optie en toont deze waarom de vorige is mislukt.
Als er meerdere opties worden gevonden, kunt u ertussen wisselen voordat u doorgaat.
Gemini CLI blijft na de configuratie beschikbaar voor normale agents, maar wordt hier niet aangeboden omdat deze de inferentieproef zonder hulpmiddelen niet kan afdwingen.
U kunt zich ook aanmelden via de eigen OAuth- of apparaatkoppelingsflow van de provider. De ingebouwde opties omvatten OpenAI/ChatGPT, OpenRouter, GitHub Copilot, Google Gemini CLI, xAI, MiniMax Global en CN, en Chutes. De lijst is afkomstig van de actieve providerplugins voor tekstinferentie van de Gateway en niet van een vaste applijst, zodat een andere provider zich kan aanmelden zonder providerspecifieke macOS-code toe te voegen.
De handmatige kiezer voor sleutels/tokens gebruikt hetzelfde providerregister. Bij elke route levert de provider het startmodel en de configuratie; OpenClaw verifieert de aanmeldgegevens met dezelfde live-test voordat het authenticatieprofiel wordt opgeslagen. Volgende blijft vergrendeld totdat één backend is geslaagd, zodat de eerste agentchat niet kan worden gestart zonder werkende inferentie. Nadat die live-controle is geslaagd, wordt Crestodian beschikbaar om de resterende werkruimte, Gateway, kanalen en andere optionele functies te configureren; Crestodian is later ook beschikbaar onder Settings → Crestodian.
Machtigingen
De onboarding vraagt TCC-machtigingen aan voor: automatisering (AppleScript), meldingen, toegankelijkheid, schermopname, microfoon, spraakherkenning, camera en locatie.
Voltooien
Nadat de inferentie is geslaagd, beheert Crestodian de resterende optionele configuratie en kan deze u doorsturen naar de normale agentchat. Na het voltooien van het machtigingstraject wordt dezelfde chat geopend; de app maakt geen werkruimte aan en start geen afzonderlijk configuratiegesprek voor de agent vóór Crestodian. Zie Bootstrapping voor wat er op de Gateway-host gebeurt tijdens de eerste echte beurt van de agent.
