First steps
Overzicht van de onboarding
OpenClaw heeft onboarding via de terminal en de macOS-app. Beide stellen eerst inferentie in: ze detecteren bestaande AI-toegang, vereisen een live voltooiing en starten pas daarna OpenClaw om de resterende installatie te configureren. Een bereikbare, geconfigureerde Gateway waarvan de standaardagent al een geconfigureerd model heeft, slaat onboarding over en opent de normale agentinterface. De terminalflow biedt ook de volledige klassieke wizard voor gedetailleerde installatie.
Welk pad moet ik gebruiken?
| CLI-onboarding | Onboarding via de macOS-app | |
|---|---|---|
| Platformen | macOS, Linux, Windows (native of WSL2) | Alleen macOS |
| Interface | Inferentie instellen, daarna OpenClaw | Inferentie instellen, daarna OpenClaw |
| Ideaal voor | Servers, headless gebruik, volledige controle | Desktop-Mac, visuele installatie |
| Automatisering | --non-interactive voor scripts |
Alleen handmatig |
| Opdracht | openclaw onboard |
Start de app |
De meeste gebruikers kunnen het beste beginnen met CLI-onboarding — dit werkt overal en geeft je de meeste controle.
Wat onboarding configureert
De begeleide inferentiefase stelt alleen het volgende in:
- Modelprovider en authenticatie — gedetecteerde toegang of een geverifieerde aanmelding bij een provider, API-sleutel of token
- Geverifieerde inferentie — een echte voltooiing met het effectieve model van de standaardagent
Nadat die voltooiing is geslaagd, kan OpenClaw de werkruimte, Gateway, Gateway-service, kanalen, agents, plugins en andere optionele functies configureren.
De klassieke CLI-wizard kan daarnaast het volgende configureren:
- Kanalen (optioneel) — ingebouwde en meegeleverde chatkanalen zoals Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp en meer
- Geavanceerde Gateway-besturingselementen — externe modus, netwerkinstellingen en daemonkeuzes
CLI-onboarding
Voer dit uit in een willekeurige terminal:
openclaw onboardDe begeleide flow detecteert bestaande AI-toegang, test kandidaten live in de juiste volgorde
en gaat bij een fout door naar de volgende. Als de detectie geen resultaat oplevert, worden eerst OpenAI,
Anthropic, xAI (Grok), Google en OpenRouter getoond. Meer… bevat de
overige providers in providergroepen, met regio's, abonnementen en ondersteunde
browser-, apparaat-, API-sleutel- of tokenmethoden in een tweede menu. Het model
en de referentiegegevens worden pas opgeslagen na een geslaagde voltooiing, waarna OpenClaw wordt gestart om
de werkruimte, Gateway, kanalen, agents, plugins en andere optionele
functies te configureren. Voorlopig overslaan sluit af zonder OpenClaw te starten. Er is geen
overdracht naar de klassieke flow binnen deze flow; sluit af en voer openclaw onboard --classic uit wanneer je
in plaats daarvan de klassieke wizard wilt gebruiken.
Nadat inferentie is geslaagd, kan OpenClaw de kanaalconfiguratie overdragen aan een gemaskeerde terminalwizard.
Hiermee wordt geen begeleide of klassieke providerconfiguratie geopend; sluit OpenClaw af en
voer openclaw onboard uit om de modelprovider of de authenticatie daarvan te wijzigen.
Gebruik openclaw onboard --classic voor gedetailleerde configuratie van model/authenticatie, kanalen, Skills,
een externe Gateway of import. Door --install-daemon toe te voegen, wordt ook de
klassieke flow geselecteerd en de achtergrondservice in één stap geïnstalleerd. Gebruik openclaw openclaw voor gespreksgestuurde installatie en reparatie zonder inferentie. openclaw onboard --modern is een compatibiliteitsalias die dezelfde live-inferentiegate
gebruikt.
Volledige naslag: Onboarding (CLI)
Documentatie voor CLI-opdrachten: openclaw onboard
Onboarding via de macOS-app
Open de OpenClaw-app. Als de geconfigureerde lokale of externe Gateway bereikbaar is en de standaardagent al een geconfigureerd model heeft, slaat de app onboarding en OpenClaw over en opent onmiddellijk de normale agentinterface.
Voor een nieuwe of onvolledig geconfigureerde Gateway detecteert de flow bij de eerste uitvoering bestaande AI- toegang (Claude Code, Codex of API-sleutels), test de beste optie live en slaat deze alleen op na een echt antwoord — met automatische terugval en een geverifieerde handmatige stap voor een API-sleutel wanneer niets wordt gevonden. Gevoelige referentiegegevens gebruiken gemaskeerde invoer. Zodra inferentie is geslaagd, start OpenClaw en helpt het de rest te configureren.
Gemini CLI blijft na de installatie beschikbaar voor normale agents, maar wordt niet aangeboden voor deze inferentiegate omdat hiermee de probe zonder tools niet kan worden afgedwongen.
Volledige naslag: Onboarding (macOS-app)
Aangepaste of niet-vermelde providers
Als je provider niet wordt vermeld, voer je openclaw onboard --classic uit, kies je
Aangepaste provider en voer je het volgende in:
- Endpointcompatibiliteit: OpenAI-compatibel (
/chat/completions), compatibel met OpenAI Responses (/responses), Anthropic-compatibel (/messages) of onbekend (probeert alle drie en detecteert automatisch) - Basis-URL en API-sleutel (de API-sleutel is optioneel als het endpoint er geen vereist)
- Model-ID en optionele modelalias
Er kunnen meerdere aangepaste endpoints naast elkaar bestaan — elk krijgt een eigen endpoint-ID.
