openclaw setup
openclaw setup is het toegangspunt voor de systeemagent. Op een geconfigureerd systeem opent alleen
openclaw setup een interactieve OpenClaw-chat. Op een nieuw systeem
wordt in plaats daarvan de begeleide onboarding gestart. Gebruik -m/--message voor één verzoek of
--baseline om configuratie-/werkruimtemappen zonder de wizard te initialiseren.
Routeringsvolgorde:
- Elke onboardingoptie (
--wizard,--baseline, werkruimte, reset, niet-interactief, flow, modus, Gateway, daemon, overslaan, importeren, extern of authenticatieopties) voert de onboarding precies zo uit alsopenclaw onboard. -m/--messageof--yesvoert de systeemagent uit.- Zonder routeringsoptie opent een geconfigureerd interactief systeem OpenClaw. Op een
nieuw systeem wordt de onboarding uitgevoerd. Op een geconfigureerd systeem drukt
--jsonhet systeemoverzicht af, zelfs zonder TTY; bij een onboardingoptie blijft de JSON-samenvatting van de onboarding behouden.
--workspace <dir> de werkruimte die aan OpenClaw wordt voorgesteld;
deze wordt pas opgeslagen nadat je het voorstel hebt goedgekeurd. Bij een nieuwe installatie
slaan de basis-, klassieke en niet-interactieve installatie de opgegeven werkruimte via hun normale flow op.
Wanneer een bestaande lijst met agents opnieuw zou worden toegewezen,
vereist de klassieke wizard expliciete bevestiging; bij een niet-interactieve installatie blijft de
huidige werkruimte van de fleet behouden en wordt een waarschuwing afgedrukt.
Begeleide inferentiedetectie wordt uitgevoerd op de Gateway-host met macOS of Linux. De CLI
en de macOS-app roepen dezelfde detector van de Gateway aan, die geconfigureerde
modellen, ondersteunde CLI-aanmeldingen, omgevingsvariabelen voor API-sleutels en reeds
geïnstalleerde modellen van Ollama of LM Studio controleert. Lokale modellen worden tijdens deze
automatische controle nooit gedownload. Gedetecteerde lokale runtimes worden na CLI- en API-sleutelkandidaten
automatisch getest; wanneer meerdere lokale modellen beschikbaar zijn, geeft OpenClaw de voorkeur aan
de krachtigste instructfamilie met ondersteuning voor toolaanroepen. De geselecteerde kandidaat moet een
echte voltooiing beantwoorden voordat de provider- en modelconfiguratie wordt opgeslagen.
Geïnstalleerde CLI’s van Gemini, Antigravity, Pi en OpenCode worden ook gemeld wanneer
ze niet als herbruikbare inferentieroute voor de begeleide installatie kunnen dienen.
setup accepteert dezelfde onboardingvlaggen als openclaw onboard, waaronder
authenticatie (--auth-choice, --token, vlaggen voor providersleutels), Gateway
(--gateway-port, --gateway-bind, --gateway-auth, --install-daemon),
Tailscale (--tailscale), reset (--reset, --reset-scope), flow
(--flow quickstart|advanced|manual|import) en overslavlaggen
(--skip-channels, --skip-skills, --skip-bootstrap, --skip-search,
--skip-health, --skip-ui, --skip-hooks). Geef --tui door om dezelfde
terminaluitweg te gebruiken als openclaw onboard --tui. Zie Onboarding en
CLI-automatisering voor het volledige vlaggenoverzicht en
niet-interactieve voorbeelden. openclaw onboard --modern blijft een compatibiliteitstoegangspunt
voor dezelfde door inferentie afgeschermde OpenClaw-assistent.
openclaw setup is bedoeld voor installaties met een wijzigbare configuratie. In de Nix-modus (OPENCLAW_NIX_MODE=1) weigert OpenClaw installatiewijzigingen te schrijven, omdat het configuratiebestand door Nix wordt beheerd. Gebruik de officiële nix-openclaw-snelstart of de equivalente bronconfiguratie voor een ander Nix-pakket.Opties
--classic en --non-interactive sluiten elkaar uit: klassiek opent de
wizard met prompts, terwijl de niet-interactieve installatie het automatiseringspad gebruikt.
Bij interactieve onboarding vullen --remote-url en --remote-token de
stap voor de externe Gateway vooraf in en hebben ze voor die uitvoering voorrang op opgeslagen externe waarden.
Wanneer je de URL wijzigt, worden opgeslagen referenties niet hergebruikt, tenzij je ook een token doorgeeft.
Het token blijft gemaskeerd en gebruikt de in de wizard geselecteerde opslagmodus voor platte tekst of SecretRef.
Basismodus
openclaw setup --baseline behoudt het oudere gedrag met alleen de basisconfiguratie: hiermee worden
de configuratie-, werkruimte- en sessiemappen gemaakt, waarna het programma afsluit zonder
de onboarding uit te voeren. Deze modus accepteert --workspace en onschadelijke uitvoeropties, maar
weigert expliciete onboarding-, Gateway-, authenticatie-, reset- of daemonopties in plaats van
ze stilzwijgend te negeren. Als een bestaande configuratie ongeldig is, behoudt de basisinstallatie
deze en wordt gevraagd openclaw doctor uit te voeren voordat je het opnieuw probeert.
Voorbeelden
Opmerkingen
- Voer na de basisinstallatie
openclaw onboarduit voor het volledige begeleide traject,openclaw configurevoor gerichte wijzigingen ofopenclaw channels addom kanaalaccounts toe te voegen. - Als een Hermes-status wordt gedetecteerd, kan de interactieve onboarding automatisch migratie aanbieden. Importonboarding vereist een nieuwe installatie; gebruik Migreren voor proefplannen, back-ups en de overschrijfmodus buiten de onboarding.