Onboarding Wizard (CLI)

De onboarding-wizard is de aanbevolen manier om OpenClaw op te zetten op macOS, Linux of Windows (via WSL2; sterk aanbevolen). Hij configureert een lokale Gateway of een remote Gateway-verbinding, plus kanalen, skills en workspace-standaarden in één begeleid proces.

openclaw onboard

Info: Snelste eerste chat: open de Control UI (geen kanaalconfiguratie nodig). Voer openclaw dashboard uit en chat in je browser. Docs: Dashboard.

Om later opnieuw te configureren:

openclaw configure
openclaw agents add <name>

Opmerking: --json impliceert geen niet-interactieve modus. Gebruik --non-interactive voor scripts.

Tip: De onboarding-wizard bevat een web search-stap waar je een provider kunt kiezen (Perplexity, Brave, Gemini, Grok of Kimi) en je API key kunt plakken zodat de agent web_search kan gebruiken. Je kunt dit ook later configureren met openclaw configure --section web. Docs: Webtools.

QuickStart vs Geavanceerd

De wizard begint met QuickStart (standaarden) vs Geavanceerd (volledige controle).

QuickStart (standaarden)

- Lokale gateway (loopback)
- Standaard workspace (of bestaande workspace)
- Gateway-poort **18789**
- Gateway-auth **Token** (automatisch gegenereerd, zelfs op loopback)
- Tool policy-standaard voor nieuwe lokale setups: `tools.profile: "coding"` (bestaand expliciet profiel wordt behouden)
- DM-isolatiestandaard: lokale onboarding schrijft `session.dmScope: "per-channel-peer"` als dat niet is ingesteld. Details: [CLI Onboarding-referentie](/docs/start/wizard-cli-reference#outputs-and-internals)
- Tailscale-blootstelling **Uit**
- Telegram + WhatsApp DM's staan standaard op **allowlist** (je wordt gevraagd om je telefoonnummer)

Geavanceerd (volledige controle)

- Geeft elke stap weer (modus, workspace, gateway, kanalen, daemon, skills).

Wat de wizard configureert

Lokale modus (standaard) leidt je door deze stappen:

  1. Model/Auth — kies een ondersteunde provider/auth-flow (API key, OAuth of setup-token), inclusief Custom Provider (OpenAI-compatible, Anthropic-compatible of Unknown auto-detect). Kies een standaardmodel. Beveiligingsnotitie: als deze agent tools gaat draaien of webhook/hooks-content gaat verwerken, gebruik dan het sterkste beschikbare laatstegeneratiemodel en houd het tool-beleid strikt. Zwakkere/oudere niveaus zijn makkelijker te prompt-injecten. Voor niet-interactieve runs slaat --secret-input-mode ref env-backed refs op in auth-profielen in plaats van plaintext API key-waarden. In niet-interactieve ref-modus moet de provider env var zijn ingesteld; inline key-flags meegeven zonder die env var faalt direct. In interactieve runs kun je bij het kiezen van secret reference-modus verwijzen naar een omgevingsvariabele of een geconfigureerde provider-ref (file of exec), met snelle preflight-validatie voor het opslaan.
  2. Workspace — Locatie voor agentbestanden (standaard ~/.openclaw/workspace). Zaait bootstrap-bestanden.
  3. Gateway — Poort, bind-adres, auth-modus, Tailscale-blootstelling. In interactieve token-modus kun je kiezen tussen standaard plaintext token-opslag of opt-in voor SecretRef. Niet-interactief token SecretRef-pad: --gateway-token-ref-env <ENV_VAR>.
  4. Kanalen — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles of iMessage.
  5. Daemon — Installeert een LaunchAgent (macOS) of systemd user unit (Linux/WSL2). Als token-auth een token vereist en gateway.auth.token door SecretRef wordt beheerd, valideert daemon-installatie het maar persisteert het resolved token niet in de metadata van de supervisor-serviceomgeving. Als token-auth een token vereist en de geconfigureerde token SecretRef niet is resolved, wordt daemon-installatie geblokkeerd met actionable guidance. Als zowel gateway.auth.token als gateway.auth.password zijn geconfigureerd en gateway.auth.mode niet is ingesteld, wordt daemon-installatie geblokkeerd totdat de modus expliciet is ingesteld.
  6. Health check — Start de Gateway en verifieert dat die draait.
  7. Skills — Installeert aanbevolen skills en optionele afhankelijkheden.

Opmerking: De wizard opnieuw draaien wist niets tenzij je expliciet Reset kiest (of --reset meegeeft). CLI --reset standaarden naar config, credentials en sessions; gebruik --reset-scope full om workspace mee te nemen. Als de config ongeldig is of legacy keys bevat, vraagt de wizard je om eerst openclaw doctor te draaien.

Remote modus configureert alleen de lokale client om te verbinden met een Gateway elders. Het installeert of wijzigt niets op de remote host.

Nog een agent toevoegen

Gebruik openclaw agents add <name> om een aparte agent aan te maken met eigen workspace, sessions en auth-profielen. Zonder --workspace draaien start de wizard.

Wat het instelt:

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

Opmerkingen:

  • Standaard workspaces 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-stap-uitleg en config-outputs, zie CLI Onboarding-referentie. Voor niet-interactieve voorbeelden, zie CLI Automation. Voor de diepere technische referentie, inclusief RPC-details, zie Wizard-referentie.

Gerelateerde docs

arrow_back
Vorige
Onboarding Overview
Volgende
Onboarding
arrow_forward