De bouwroute door OpenClaw

OpenClaw is geen complex systeem om op te zetten, maar het is geen single-command-install. Er zijn keuzes te maken, externe credentials in te regelen, en een aantal opeenvolgende stappen waar elk een eigen check verdient. Wat hieronder volgt is een doe-route, geen reference-documentatie. Volg het in volgorde, sla niet over, en gebruik de checks na elke stap om te bevestigen dat je goed zit.

01 · WAT JE NODIG HEBTDe prerequisites op je machine

Voordat je begint, moet de host gereed zijn. De lijst is kort maar elk item is harde voorwaarde.

• OS: macOS (best getest), Linux, of Windows. Voor de macOS-menubar-app heb je macOS nodig; voor headless servers Linux.
• Node.js 22 of hoger. OpenClaw is TypeScript en draait op Node. Check met node --version. Installeer indien nodig via Homebrew (brew install node@22) of een Node-version-manager.
• Tenminste één LLM API-key. Anthropic Claude is de aanbevolen eerste keuze (ANTHROPIC_API_KEY). Alternatieven: OpenAI, Gemini, OpenRouter, of lokaal via Ollama. Voor lokaal Ollama heb je geen API-key nodig.
• Voldoende disk en RAM. OpenClaw zelf is licht; het zware werk zit bij Docker-images voor sandboxing en eventuele lokale modellen. Reserveer minimaal 4GB RAM en 5GB disk.
• Docker, alleen als je sandboxing wilt activeren. Default is sandbox non-main, dus reken op Docker tenzij je het uitschakelt.
• Network. Outbound HTTPS naar je LLM-provider en messaging-platforms. Geen inbound nodig tenzij je hooks via webhooks aanbiedt.

02 · INSTALLATIEOpenClaw op je machine zetten

De installatie is één commando met daarna een controle-stap.

npm install -g openclaw@latest

Verifieer:

openclaw --version

Je zou een versie als 2026.5.22 moeten zien. Als het commando niet wordt gevonden, voeg dan het npm-prefix-pad toe aan je shell-rc:

npm prefix -g
# voeg het uitgevoerde pad toe aan ~/.zshrc:
export PATH="$(npm prefix -g)/bin:$PATH"

Op macOS kan een sharp-related installatie-fout optreden. Probeer dan:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

03 · EERSTE SETUPDe onboarding wizard

Met OpenClaw geïnstalleerd, draai de onboarding-wizard. Die begeleidt je door de essentiële configuratie-keuzes.

openclaw onboard --install-daemon

De wizard loopt door vier stappen.

Gateway-authenticatie. Je krijgt de keuze om een token in te stellen voor het beveiligen van de gateway. Genereer een token met openssl rand -hex 32 en zet hem in een environment variable. Hardcode geen tokens in openclaw.json; gebruik ${OPENCLAW_GATEWAY_TOKEN}-syntax.

LLM-provider. Voer je API-key in voor je gekozen provider. Anthropic vraagt om ANTHROPIC_API_KEY, OpenAI om OPENAI_API_KEY, en zo verder. Voor lokaal Ollama hoef je geen key in te voeren, OpenClaw detecteert Ollama automatisch op localhost:11434.

Eerste kanaal. Hier kun je een eerste channel toevoegen of dit overslaan en later doen. Voor de eerste keer is “overslaan” prima; je leert eerst praten met je claw via de TUI of de macOS-menubar-app, dan koppel je een kanaal.

Daemon-installatie. Op macOS via launchd, op Linux via systemd. Dit zorgt dat de gateway op de achtergrond draait zonder dat je een terminal open hoeft te houden.

Na afloop:

openclaw status

Toont running-status, gekoppelde providers, en eventuele warnings.

04 · JE EERSTE AGENTMet een claw praten

Met de gateway draaiend kun je voor het eerst met je claw praten. Drie manieren om te starten:

Via TUI (snel, in de terminal):

openclaw tui

Via macOS-menubar-app (op macOS): klik het OpenClaw-icoon in je menubar en open een chat-window.

Via web-dashboard:

openclaw dashboard

Of navigeer direct naar http://127.0.0.1:18789/.

Stuur een test-bericht: “Hallo, wie ben je?” De claw zou moeten reageren met zijn naam (default is iets als Claw) en korte uitleg. Werkt dat niet, check dan openclaw doctor:

openclaw doctor --fix

Dat probeert configuratie-issues automatisch op te lossen. Voor handmatige diagnose:

openclaw logs --follow

Volgt de logs live. Errors zien er expliciet uit, met meestal een suggestie voor de fix.

05 · SKILLS TOEVOEGENDe claw nieuwe vaardigheden geven

Skills zijn de vaardigheden van de claw. Zonder skills kan hij praten en eenvoudige built-in tools gebruiken; met skills wordt hij nuttig voor specifieke domeinen.

Bekijk welke skills al beschikbaar zijn:

openclaw skills list
openclaw skills list --eligible

Een “eligible” skill is een skill waarvan alle vereisten (zoals API-keys of externe tools) aanwezig zijn. Voor specifieke skills die externe software vereisen:

openclaw skills check --verbose

Toont per skill wat er nog mist. Installeer ontbrekende dependencies waar nodig.

Drie eerste skills die meestal direct waardevol zijn:

• memory-search: semantisch zoeken door eigen geheugen. Activeer via agents.defaults.memorySearch.enabled: true in config.
• web-search en web-fetch: de claw kan het web op. Voor web-search is meestal een API-key voor een search-provider nodig.
• apple-notes (op macOS): toegang tot Apple Notes. Direct nuttig voor wie daar al organiseert.

Custom skills schrijven gaat via een mapje in je workspace:

mkdir -p ~/.openclaw/workspace/skills/mijn-skill

Maak een SKILL.md:

---
name: mijn_skill
description: "Wat de skill doet"
metadata:
  openclaw:
    emoji: "🔧"
    requires:
      bins: ["curl"]
      env: ["MY_API_KEY"]
---

# Mijn Skill

Wanneer de gebruiker vraagt om X, doe Y, en gebruik Z.

Hot-reload pakt nieuwe of gewijzigde skills binnen 250ms op; herstart niet nodig.

06 · CHANNELS EN HOOKSDe claw in je messaging-apps

Met een werkende claw en relevante skills, koppel een kanaal. Begin met één; voeg pas meer toe als de eerste werkt.

Telegram is de veiligste eerste keuze (officiële Bot API):

1. Maak een bot via @BotFather en noteer het token.
2. Voeg de token toe aan je environment:

   export TELEGRAM_BOT_TOKEN="123456:ABC..."
   

3. De gateway pakt het hot-reload op. Verifieer:

   openclaw channels status
   

Discord vergt iets meer: een bot maken in het Discord Developer Portal, Message Content Intent aanzetten, en het token toevoegen.

WhatsApp is mogelijk maar risicovol. Lees eerst Deel 3 van de fieldguide: WhatsApp verbiedt onofficiële clients in zijn ToS en kan je nummer bannen. Gebruik nooit je hoofdnummer; gebruik een tweede SIM of virtual number.

Hooks koppel je via:

openclaw webhooks gmail setup --account jouw-email@gmail.com --project gcp-project

Voor andere hooks: configureer hooks.mappings in openclaw.json. Een eenvoudige hook leeft in ~/.openclaw/hooks/<naam>/ met HOOK.md en handler.ts.

07 · DEPLOYMENTVan je laptop naar iets duurzamers

Voor persoonlijk gebruik is je laptop genoeg. Maar de claw heeft pas écht waarde wanneer hij ook draait als je laptop dicht is. Drie deployment-paden, oplopend in complexiteit.

Always-on op je eigen machine. De simpelste optie. Met openclaw onboard --install-daemon draait de gateway al als achtergrondservice. Zorg dat je laptop niet slaapt, of accepteer dat de claw alleen leeft wanneer jij in slaapt.

Op een eigen server. Een Mac Mini, een Linux-VPS, of een lokale Raspberry Pi 5. Installeer OpenClaw, configureer met je credentials, draai als service. De gateway bind op loopback als je via SSH-tunnels of Tailscale benadert; op lan als de server in je netwerk staat en je vanaf andere devices wilt connecten.

Containerized. Een Docker-image voor OpenClaw zelf, eventueel met orchestratie. De fieldguide gaat hier niet diep op in; het patroon is hetzelfde als elk Node-proces in productie. Aandacht voor: persistent volumes voor de workspace, environment variables voor credentials, network policy voor inbound webhooks.

Voor productie-grade setups: monitor de gateway via openclaw status --deep, integreer met je log-aggregatie, configureer cron-failure-alerts.

08 · ONDERHOUDDe terugkerende handelingen

OpenClaw is geen install-and-forget. Een paar terugkerende handelingen:

Updates. Wekelijks of bij belangrijke fieldguide-updates:

openclaw update

Pakt nieuwste versie, valideert config-compatibiliteit, herstart de gateway. Voor wie bleeding-edge wil: --channel beta. Voor wie altijd stabiel: niets, default is stable.

Security-audits. Na elke update:

openclaw security audit
openclaw security audit --fix

Loopt door de zes security-checks (gateway bind, auth, DM-policy, bestandsrechten, tool-beperkingen, mention-policy). --fix lost wat automatisch kan.

Memory-onderhoud. Wekelijks of als geheugen rommelig wordt:

openclaw memory status
openclaw memory index

Voor wie de optionele memory-wiki gebruikt:

openclaw wiki doctor

Cron-checks. Bekijk lopende cron-jobs en hun status:

openclaw cron status
openclaw cron list

Backups. Wanneer je workspace inhoudelijk waardevol is geworden:

openclaw backup create

Maakt een tar van workspace, sessies en config. Bewaar op een veilige plek; deze tar bevat geen credentials, maar wel je persoonlijkheid-bestanden en conversatie-geschiedenis.

09 · VOLGENDE STAPPENWaar je hierna naartoe kunt

De bouwroute eindigt hier, maar OpenClaw begint hier pas. Drie richtingen voor wat je hierna kunt doen.

Meerdere agents en multi-channel-setups. Werk en thuis als aparte claws, elk met eigen workspace, persoonlijkheid, model. Routing-regels in openclaw.json bepalen wie welk kanaal bedient. Begin met twee agents en breid uit als je weet wat ze van elkaar zouden moeten weten.

Heartbeat en cron voor proactiviteit. Maak de claw verantwoordelijk voor terugkerende taken. Een dagelijkse briefing om 7:00, een wekelijkse projectanalyse op maandag, een check op openstaande issues elk uur. Schrijf de regels in HEARTBEAT.md of via openclaw cron add.

Eigen skills schrijven. Wanneer je gebruikspatronen ziet die niet door bestaande skills worden gedekt, schrijf je eigen. Een skill is een mapje met een markdown-bestand en eventueel scripts. De hot-reload maakt het iteratieve schrijven plezierig.

Voor de conceptuele kant van OpenClaw, lees de Mental Pill op deze body. Voor de technische diepte, de Developer Pill. Voor de risico-laag, de Security Pill. Voor de bron zelf zonder lens, de Placebo.