OpenClaw (Clawdbot) Tutorial: Bediening van je pc via WhatsApp

Je staat koffie te halen wanneer er in Slack wordt gevraagd om dat kwartaalrapport. Het staat op je bureaublad thuis. Je stuurt via WhatsApp: "Zoek de Q4-rapportage-PDF op mijn bureaublad." Dertig seconden later heb je het pad en kun je je collega naar de gedeelde schijf verwijzen. Dat is OpenClaw.

OpenClaw draait een lokale gateway die chatapps verbindt met een code-agent op basis van Claude. Je stuurt berichten via WhatsApp, Telegram of de terminal, en de agent reageert door opdrachten op je machine uit te voeren: bestanden zoeken, scripts draaien en logs lezen. De gateway blijft op je computer draaien en verzorgt de vertaling tussen chat en shell.

In deze tutorial zetten we OpenClaw vanaf nul op en verkennen we de vele taken die je ermee kunt uitvoeren. We bespreken ook waar je op moet letten als een AI als deze onbeperkte terminaltoegang heeft.

Let op: Terwijl we dit artikel schreven, deed Anthropic een merkaanvraag omdat "Clawd" te veel leek op "Claude". Het project werd omgedoopt van Clawdbot naar Moltbot (met behoud van de kreeft-mascotte). Vervolgens veranderde op 29 januari 2026 de naam opnieuw naar OpenClaw. Sommige screenshots, configpaden en codefragmenten in deze tutorial kunnen nog steeds verwijzen naar "Clawdbot", "clawd" of "moltbot".

Als je meer wilt leren over het Claude-ecosysteem, bekijk dan onze gidsen over Claude Cowork, Claude Code, Claude Opus 4.6, en onze cursus Introduction to Claude Models. Je vindt ook onze gids over OpenClaw met Ollama en onze gids voor Moltbook.

Wat is OpenClaw?

Peter Steinberger, een macOS-ontwikkelaar bekend om Apple-tools, bracht dit project eind 2025 uit, oorspronkelijk onder de naam Clawdbot. De pitch: een volledig self-hosted AI-agent waarbij je prompts en bestanden je hardware nooit verlaten, behalve wanneer ze naar de door jou geconfigureerde model-API worden gestuurd. 

Deze privacy-first aanpak sloeg aan bij ontwikkelaars die het zat waren om alles via cloudproviders te routeren. De repo ging over de 60.000 GitHub-sterren binnen enkele weken.

De Gateway-architectuur

Alles loopt via één daemon, de Gateway. Die blijft op de achtergrond draaien, houdt je chatverbindingen open en coördineert de AI-agent. Dit is de volgorde wanneer je een bericht stuurt:

• Je tekst komt binnen via WhatsApp (Baileys-protocol), Telegram (Bot API), Discord, iMessage of CLI.
• De Gateway geeft het door aan een ingebedde code-agent genaamd Pi, die shell-opdrachten voor je kan uitvoeren.
• Pi stuurt de prompt naar je modelprovider.
• Het model reageert met instructies die Pi lokaal uitvoert.
• Resultaten gaan via de Gateway terug naar je chat.

De Gateway regelt sessiebeheer, streaming van antwoorden en een lokaal webdashboard voor configuratie. Hij installeert zich als systeemservice (launchd op macOS, systemd op Linux) en overleeft automatisch herstarts.

OpenClaw-installatiegids: vereisten en installatie

Laten we nu leren hoe je OpenClaw instelt.

Systeemvereisten en API-kosten

OpenClaw heeft Node.js 22 of hoger nodig en draait native op macOS en Linux. Windows-gebruikers hebben WSL2 (Windows Subsystem for Linux) nodig, wat prima werkt maar een extra laag installatie vereist.

Hardwarevereisten zijn minimaal. De Gateway gebruikt in idle-stand weinig CPU en geheugen. Elke machine die een moderne browser kan draaien, kan OpenClaw draaien.

OpenClaw zelf is gratis en open source (MIT-licentie). De kosten komen van API-tokens. Anthropic rekent per miljoen tokens: ongeveer $3 voor input en $15 voor output met Claude Sonnet, meer voor Opus. Wat betekent dat in de praktijk?

• Licht gebruik (enkele opdrachten per dag): $10-30/maand
• Gemiddeld gebruik (regelmatige bestandstaken, research): $30-70/maand
• Zwaar gebruik (constante automatisering, lange sessies): $70-150/maand

Deze bedragen variëren op basis van prompt-omvang en contextgrootte. Als je een Claude Pro- of Max-abonnement hebt, kun je een setup-token genereren via de Claude Code CLI en je abonnement gebruiken in plaats van per token te betalen.

Stap-voor-stap OpenClaw-installatie

Voer het installatiescript uit:

curl -fsSL https://molt.bot/install.sh | bash

Na installatie start de onboardingwizard automatisch. Het eerste wat je ziet is een beveiligingswaarschuwing. De wizard linkt naar documentatie over sandboxing als je wilt beperken wat de agent kan doen.

De wizard biedt QuickStart (logische standaarden) of Advanced (volledige controle). QuickStart werkt voor de meesten.

Kies vervolgens je modelprovider. Als je een Claude Max- of Pro-abonnement hebt, selecteer de setup-tokenoptie. Open een aparte terminal en voer claude setup-token uit en plak daarna het gegenereerde token in de wizard.

Voor kanaalinstelling kies je WhatsApp en scan je de QR-code met je telefoon (Instellingen → Gekoppelde apparaten → Apparaat koppelen). Andere kanalen zoals Telegram en Discord zijn ook beschikbaar.

De wizard vraagt daarna naar skillsconfiguratie. Skills breiden uit wat OpenClaw kan, maar vereisen extra afhankelijkheden.

Sla dit voorlopig over om de initiële setup simpel te houden. Tip: gebruik Spatie om opties te toggelen en Enter om te bevestigen.

Na het overslaan van hooks-configuratie, installeert de Gateway-service automatisch. De wizard vraagt hoe je je bot wilt "uitbroeden". De TUI (Terminal User Interface)-optie opent zowel een terminalchatinterface als het webdashboard.

Test nu WhatsApp. Stuur een bericht naar jezelf. Je vraag en het antwoord van OpenClaw verschijnen op alle drie de plekken: de terminal, de web-UI en WhatsApp.

Zie je reacties in alle drie de interfaces, dan ben je live.

OpenClaw in actie: ingebouwde mogelijkheden

Tien minuten instellen en je hebt al een werkende agent. De volgende voorbeelden laten zien wat OpenClaw standaard kan.

Voorbeeld 1: Een begraven screenshot vinden en versturen

Stel, je bent niet thuis en je realiseert je dat je vergat een bestand naar jezelf te sturen. Het staat op je laptop thuis.

Ik testte dit scenario met de screenshot die ik tijdens de setup had gemaakt, waarop de eerste reactie van OpenClaw te zien was. Het bestand had een generieke naam en lag begraven tussen tientallen andere afbeeldingen in mijn Downloads-map.

Mijn bericht aan OpenClaw: "Ik had een screenshot in mijn Downloads-map van een WhatsApp-gesprek. Kun je die vinden en hier sturen?"

De agent bekeek afbeeldingen één voor één. Toen hij het juiste bestand vond, stuurde hij het terug via de chat.

Toen de agent voor het eerst mijn Downloads-map benaderde, vroeg macOS om toestemming. Als je OpenClaw op afstand wilt gebruiken, geef dan vooraf Volledige schijftoegang (zie de sectie Beveiliging voor details).

Voorbeeld 2: Schijfruimterapport met grafieken

Stel vervolgens dat een collega je een groot bestand via Dropbox wil sturen. Voor het zover is, wil je zeker weten dat je machine ruimte heeft om het te downloaden. Je zou Finder kunnen doorzoeken of terminalopdrachten draaien, maar je zit op je telefoon tijdens een weekendtrip en wilt een snel antwoord.

Je bericht aan OpenClaw: "Controleer mijn schijfruimte en genereer een PDF-rapport met grafieken (gemaakt met Python) dat gebruik per map toont."

Deze taak vereist meerdere stappen: het bestandssysteem scannen, groottes per directory aggregeren, Python-code schrijven om grafieken te genereren en alles naar PDF exporteren.

Het antwoord dat je nodig had: 94 GB vrij. De PDF bevatte een cirkeldiagram en een staafdiagram met de verdeling. OpenClaw gaf ook aan dat Library de grootste boosdoener was met ~300 GB.

Wat me opviel is dat OpenClaw de neiging heeft terughoudend te zijn. Geef dezelfde prompt aan Claude Code of een andere code-agent, en die gaan helemaal los. Je krijgt zo een dozijn grafieken met diepe directory-onderverdelingen.

Hier sloot OpenClaw aan bij de beknoptheid van mijn prompt: twee grafieken, topmappen, klaar. Wil je meer detail, vraag daar dan expliciet om.

OpenClaw uitbreiden met Custom Skills

Waarschijnlijk heb je terugkerende workflows: je agenda checken voor een meeting, je notitie-app doorzoeken, posten op social media, smarthomeapparaten bedienen. Deze taken volgen patronen. 

Met skills kun je OpenClaw die patronen één keer aanleren, zodat het ze voortaan voor je afhandelt.

Een skill is een map met een SKILL.md-bestand en optioneel scripts, configs of andere resources. De markdown heeft YAML-frontmatter (naam, omschrijving, vereisten) en stapsgewijze instructies die in de context van de agent worden geladen. 

Wanneer je verzoek overeenkomt met een skill, volgt de agent die instructies in plaats van alles vanaf nul uit te vogelen. Skills kunnen ook helperscripts bundelen voor complexe workflows, zodat alles wat de agent nodig heeft op één plek leeft.

Het formaat volgt de AgentSkills-spec, een open standaard oorspronkelijk ontwikkeld door Anthropic en nu breed geadopteerd: Claude Code, Cursor, VS Code, OpenAI Codex, Gemini CLI, GitHub Copilot, en anderen. 

Als je bekend bent met de Claude Agent SDK, herken je het patroon. Bouw een skill voor OpenClaw, en hij werkt in elke AgentSkills-compatibele tool.

Zo ziet de frontmatter eruit voor de GitHub-skill:

---
name: github
description: Interact with GitHub using the gh CLI.
metadata: {"openclaw":{"requires":{"bins":["gh"]}}}
---

Het veld requires.bins betekent dat deze skill alleen laadt als gh is geïnstalleerd. Skills kunnen ook om omgevingsvariabelen (API-sleutels) of specifieke configflags vragen. Als niet aan een vereiste is voldaan, blijft de skill inactief totdat je de dependency installeert.

Ingebouwde OpenClaw-skills

OpenClaw wordt geleverd met 49 gebundelde skills voor veelvoorkomende workflows. Voer openclaw skills list uit om te zien welke op jouw systeem klaarstaan.

• Apple-ecosysteem: Notes, Herinneringen, Things 3, Bear Notes. Vraag OpenClaw om een herinnering toe te voegen of je notities te doorzoeken en het kent de juiste CLI-commando’s.
• Google Workspace: Gmail, Agenda, Drive, Docs, Sheets via de gog CLI. Vereist OAuth-setup, maar daarna kun je vragen "wat staat er morgen op mijn agenda" of "maak een conceptantwoord op die e-mail van Sarah."
• Communicatie: Slack, iMessage, Twitter/X. Plaats tweets, reageer op Slack-berichten of doorzoek je iMessage-geschiedenis.
• Smarthome: Philips Hue, Sonos, Eight Sleep. Bedien verlichting, speel muziek af, pas je bedtemperatuur aan.
• Devtools: GitHub CLI voor issues en PR’s, een coding-agent-skill die Claude Code als subprocess start, Whisper voor transcriptie.

De meeste skills wikkelen bestaande CLI-tools in. Als de onderliggende binary ontbreekt, staat de skill als niet-beschikbaar totdat je hem installeert.

Je eigen OpenClaw-skills maken

Ingebouwde skills dekken het algemene werk, maar de echte winst komt als je skills bouwt voor je eigen workflows. Afbeeldingsbewerking is een goed voorbeeld: je maakt foto’s op je telefoon, maar voor resize en watermarken moet je meestal achter een computer zitten. Met een custom skill kun je die workflow via WhatsApp draaien terwijl je onderweg bent.

Ik vroeg OpenClaw om een skill te maken die afbeeldingen naar elke resolutie resizet en een generiek logo toevoegt op ~/Documents/logo.png. Het gebruikte de gebundelde skill-creator om een Python-script met PIL te schrijven, de mapstructuur te genereren en een SKILL.md met gebruiksvoorbeelden te maken.

De skill kwam terecht in de skills/-map van mijn workspace en werd bij de volgende sessie geladen. Om te testen stuurde ik een screenshot van de OpenClaw-homepage en vroeg ik OpenClaw om hem voor LinkedIn te resizen met het watermerk.

Een paar seconden later had ik de afbeelding terug, voorzien van watermerk en klaar om te posten. Die skill staat nu permanent op mijn machine en is oproepbaar vanaf mijn telefoon wanneer ik hem nodig heb.

Wil je inspiratie of liever hergebruiken wat anderen hebben gebouwd, bekijk dan awesome-openclaw-skills. De repo indexeert 565+ communityskills. Een paar sterke voorbeelden:

• Tesla: Auto vergrendelen, airco starten, laadniveau checken. Handig als je naar de parkeergarage loopt en de airco alvast aan wilt.
• Home Assistant: Volledige smarthomebediening. "Doe de lampen in de woonkamer uit" vanaf waar dan ook.
• Picnic: Boodschappen bestellen. Zoek producten, voeg toe aan je winkelwagen, plan levering via chat.

Geavanceerde OpenClaw-functies

De voorbeelden tot nu toe behandelen OpenClaw als een reagerende assistent: jij vraagt, hij handelt. Maar drie functies tillen het verder dan basischat.

• Persistente geheugen laat de agent je voorkeuren onthouden over sessies en platforms heen. 
• Proactieve monitoring betekent dat hij je zonder prompt kan benaderen. 
• En sandboxing pakt de voor de hand liggende zorg aan: een AI met terminaltoegang heeft vangrails nodig.

Persistent geheugen en aanpassing

OpenClaw slaat zijn context op in markdownbestanden onder ~/clawd/. Elk bestand heeft een eigen doel:

SOUL.md bepaalt hoe de agent communiceert. Persoonlijkheid, toon, grenzen. Zo begint het standaard:

# SOUL.md - Who You Are
 
*You're not a chatbot. You're becoming someone.*
 
## Core Truths
 
**Be genuinely helpful, not performatively helpful.** Skip the "Great question!"
and "I'd be happy to help!" — just help. Actions speak louder than filler words.
 
**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing
or boring. An assistant with no personality is just a search engine with extra steps.
 
**Be resourceful before asking.** Try to figure it out. Read the file. Check the
context. Search for it. *Then* ask if you're stuck.

AGENTS.md bepaalt wat de agent elke sessie moet doen en hoe zich te gedragen. Het bevat veiligheidsregels, groepschatetiquette en instructies voor het gebruik van tools. De opening:

# AGENTS.md - Your Workspace
 
This folder is home. Treat it that way.
 
## Every Session
 
Before doing anything else:
1. Read SOUL.md — this is who you are
2. Read USER.md — this is who you're helping
3. Read memory/YYYY-MM-DD.md (today + yesterday) for recent context
4. **If in MAIN SESSION** (direct chat with your human): Also read MEMORY.md

USER.md slaat feiten over jou op. Als je OpenClaw iets laat onthouden, komt het hier. Nadat ik de agent vertelde dat ik Breaking Bad leuk vind:

# USER.md - About Your Human
 
## Context
 
### Entertainment Preferences
- **TV Shows:** Loves Breaking Bad

IDENTITY.md is waar de agent zichzelf definieert: zijn naam, vibe, emoji, avatar. Je vult dit in tijdens de setup of laat de agent kiezen.

Twee extra bestanden worden in de documentatie genoemd maar on-demand aangemaakt:

• MEMORY.md: Langetermijn, gecureerde herinneringen. De agent maakt dit aan wanneer er iets is dat het bewaren waard is voorbij de dagnotities. Alleen geladen in hoofdsessies (niet in groepschats) om privacyredenen.
• memory/YYYY-MM-DD.md: Dagnotities. Rauwe logs van wat er gebeurde. De agent maakt de map memory/ aan zodra hij er een moet schrijven.

Om een van deze bestanden te wijzigen, hoef je het alleen maar te vragen. "Werk SOUL.md bij zodat het beknopter is." "Voeg aan USER.md toe dat ik in fintech werk." De agent bewerkt het bestand direct, en wijzigingen blijven behouden over sessies en platforms heen.

Proactieve alerts en monitoring

De meeste AI-agents wachten tot jij iets vraagt. OpenClaw kan contact initiëren via twee mechanismen.

Heartbeats draaien periodieke checks en bundelen die in één beurt. Zo stel je er een in:

1. Bewerk ~/clawd/HEARTBEAT.md met een checklist van dingen om te monitoren:

# Heartbeat checklist
- Check email for urgent messages
- Review calendar for events in next 2 hours
- If idle for 8+ hours, send a brief check-in

2. Configureer het interval in ~/.clawdbot/clawdbot.json:

{
  "agents": {
	"defaults": {
  	"heartbeat": {
    	"every": "30m",
    	"activeHours": { "start": "08:00", "end": "22:00" }
  	}
	}
  }
}

3. Herstart de Gateway: openclaw gateway restart

Elke 30 minuten tijdens actieve uren loopt OpenClaw de checklist door. Als niets aandacht vereist, blijft het stil.

Cronjobs regelen precieze, eenmalige of terugkerende taken. Voer deze commando’s uit in je terminal:

# Daily morning briefing at 7am
openclaw cron add --name "Morning brief" --cron "0 7 * * *" --message "Weather, calendar, top emails"
 
# One-shot reminder in 2 hours
openclaw cron add --name "Call back" --at "2h" --session main --system-event "Call the client"
 
# List active cron jobs
openclaw cron list
 
# Remove a job by ID (get the ID from the list output)
openclaw cron rm <job-id>

Het verschil: heartbeats bundelen meerdere checks in één beurt en delen de context van je hoofdsessie. Cronjobs draaien op exacte tijden en kunnen geïsoleerde sessies met schone context gebruiken. 

Gebruik heartbeats voor "controleer deze dingen periodiek." Gebruik cron voor "doe dit specifieke ding op dit specifieke tijdstip." Als je met Claude Code-hooks hebt gewerkt, voelt het automatiseringsmodel vertrouwd.

Beveiliging en sandboxing

Een AI met shelltoegang kan bestanden verwijderen, credentials lekken of kwaadaardige opdrachten uitvoeren via promptinjectie. Securityonderzoekers hebben echte kwetsbaarheden gevonden: authenticatieomzeiling wanneer de gateway achter een verkeerd geconfigureerde reverse proxy staat, en credentiallekken wanneer de webinterface aan een publiek adres wordt gebonden. 

Peter Steinberger raadt aan OpenClaw op dedicated hardware te draaien, zoals een Mac Mini of VPS.

De meeste gebruikers doen dat niet. Als je het op je hoofdmachine draait, beperkt sandboxing de impact.

Zo stel je sandboxing in:

1. Zorg dat Docker is geïnstalleerd en draait.

2. Bouw het sandbox-image. Vanuit de OpenClaw-bronmap (waar je de repo hebt gecloned of waar npm het installeerde):

./scripts/sandbox-setup.sh

3. Voeg de sandboxconfig toe aan ~/.clawdbot/clawdbot.json:

{
  "agents": {
	"defaults": {
  	"sandbox": {
    	"mode": "non-main",
    	"scope": "session",
    	"workspaceAccess": "ro"
  	}
	}
  }
}

4. Herstart de Gateway: openclaw gateway restart

Wat de instellingen betekenen:

De instelling mode bepaalt welke sessies gesandboxed worden:

• "off": Geen sandboxing. Dit is de standaard en is risicovol.
• "non-main": Sandbox voor groepschats en externe kanalen, terwijl je hoofdterminalsessie op de host draait. Aanbevolen voor de meeste gebruikers.
• "all": Elke sessie draait gecontaineriseerd. Het veiligst, maar voegt latentie toe.

De instelling workspaceAccess bepaalt wat gesandboxte sessies kunnen zien:

• "none": Geïsoleerde workspace. De agent kan je bestanden helemaal niet zien.
• "ro": Alleen-lezen toegang tot ~/clawd/. De agent kan lezen maar niet wijzigen.
• "rw": Volledige lees-schrijf-toegang. Gebruik spaarzaam.

Trade-offs om te kennen: Sandboxing voegt latentie toe door container-opstart. Skills die netwerktoegang nodig hebben werken standaard niet omdat containers geen netwerk hebben. De instelling tools.elevated omzeilt de sandbox volledig, dus controleer wat je toestaat. Sommige platformlimieten gelden sowieso: slechts één Gateway kan eigenaar zijn van een WhatsApp-sessie, en iMessage werkt alleen op macOS.

Eén macOS-specifiek punt: Voordat je op OpenClaw op afstand vertrouwt, geef Volledige schijftoegang aan je terminalapp in Systeeminstellingen → Privacy & Beveiliging → Volledige schijftoegang. Toestemmingsprompts verschijnen niet wanneer je weg bent, en geblokkeerde toegang faalt stilletjes.

Tot slot

OpenClaw neemt een unieke plek in binnen het landschap van AI-agents. Het probeert je IDE niet te vervangen of een algemene chatbot te worden. Het is een brug tussen de AI-modellen waarvoor je al betaalt en de bestanden, apps en automatiseringen op je eigen hardware.

Het project beweegt snel. Skillbibliotheken groeien wekelijks, en de community bouwt integraties voor alles van boodschappen bezorgen tot Tesla-bediening. Naarmate lokale modellen via Ollama verbeteren, wordt een volledig offline persoonlijke agent steeds haalbaarder.

De echte vraag is niet of AI-agents ons digitale leven gaan beheren. Het is of we ze draaien op infrastructuur die wij controleren of dat we dat aan cloudproviders overlaten. OpenClaw zet in op local-first, en voor gebruikers die geven om privacy en eigenaarschap begint die gok zich uit te betalen. Voor meer over desktop-AI-agents, bekijk onze tutorial over Claude Cowork.