Naar hoofdinhoud gaan

​
Onboardingwizard (CLI)

De onboardingwizard is de aanbevolen manier om OpenClaw in te stellen op macOS, Linux of Windows (via WSL2; sterk aanbevolen). Hij configureert een lokale Gateway of een externe Gateway-verbinding, plus kanalen, skills en werkruimte-standaardinstellingen in één begeleide flow. 
openclaw onboard
Snelste eerste chat: open de Control UI (geen kanaalinstelling nodig). Voer uit openclaw dashboard en chat in de browser. Documentatie: Dashboard.
Later opnieuw configureren: 
openclaw configure
openclaw agents add <name>
--json impliceert geen niet-interactieve modus. Gebruik voor scripts --non-interactive.
Aanbevolen: stel een Brave Search API-sleutel in zodat de agent web_search kan gebruiken (web_fetch werkt zonder sleutel). Makkelijkste route: openclaw configure --section web waarmee tools.web.search.apiKey wordt opgeslagen. Documentatie: Web tools.

​
Snelstart vs Geavanceerd

De wizard start met QuickStart (standaardwaarden) versus Advanced (volledige controle).
  • Lokale Gateway (loopback)
  • Werkruimte-standaard (of bestaande werkruimte)
  • Gateway-poort 18789
  • Gateway-auth Token (automatisch gegenereerd, zelfs op loopback)
  • Tailscale-blootstelling Uit
  • Telegram + WhatsApp-DM’s staan standaard op toegestane lijst (je wordt gevraagd om je telefoonnummer)

​
Wat de wizard configureert

Lokale modus (standaard) leidt je door deze stappen:
  1. Model/Auth — Anthropic API-sleutel (aanbevolen), OAuth, OpenAI of andere providers. Kies een standaardmodel.
  2. Werkruimte — Locatie voor agentbestanden (standaard ~/.openclaw/workspace). Zaait bootstrapbestanden.
  3. Gateway — Poort, bind-adres, auth-modus, Tailscale-blootstelling.
  4. Kanalen — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles of iMessage.
  5. Daemon — Installeert een LaunchAgent (macOS) of systemd user unit (Linux/WSL2).
  6. Health check — Start de Gateway en verifieert dat deze draait.
  7. Skills — Installeert aanbevolen skills en optionele afhankelijkheden.
Het opnieuw uitvoeren van de wizard wist niets, tenzij je expliciet Reset kiest (of --reset meegeeft). Als de config ongeldig is of verouderde sleutels bevat, vraagt de wizard je eerst openclaw doctor uit te voeren.
Externe modus configureert alleen de lokale client om verbinding te maken met een Gateway elders. Er wordt niets geïnstalleerd of gewijzigd op de externe host.

​
Nog een agent toevoegen

Gebruik openclaw agents add <name> om een aparte agent te maken met een eigen werkruimte, sessies en auth-profielen. Uitvoeren zonder --workspace start de wizard. Wat het instelt:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Notities:
  • Standaardwerkruimtes volgen ~/.openclaw/workspace-<agentId>.
  • Voeg bindings toe om inkomende berichten te routeren (de wizard kan dit doen).
  • Niet-interactieve flags: --model, --agent-dir, --bind, --non-interactive.

​
Volledige referentie

Voor gedetailleerde stap-voor-stapbeschrijvingen, niet-interactieve scripting, Signal-instelling, RPC API en een volledige lijst van configvelden die de wizard wegschrijft, zie de Wizard Reference.

​
Gerelateerde documentatie