OpenClaw voor wie hier nieuw is

OpenClaw kan overweldigend zijn voor wie hier voor het eerst belandt. De fieldguide vooronderstelt al snel dat je weet wat een gateway is, wat een sessie is, en waarom je een agent zou willen die niet in een browser-tab leeft. Wat hieronder volgt is een rustigere ingang: niet versimpeld onder de waarheid, wel uitleg-zonder-aanname. Voor wie geen voorkennis heeft van AI-agents, self-hosting of messaging-runtimes, en die het in zijn eigen tempo wil begrijpen.

01 · WAT IS EEN AI-AGENT EIGENLIJKHet verschil tussen een chatbot en een agent

Iedereen heeft inmiddels met ChatGPT of Claude.ai gepraat. Je typt een vraag, je krijgt een antwoord, je sluit het tabblad. De volgende keer dat je het opent, begint het gesprek opnieuw. Dat is een chatbot: een ding dat reageert op wat je stuurt en daarna idle is.

Een agent is iets anders. Een agent heeft toegang tot bestanden, tot het internet, tot specifieke tools. Hij kan dingen doen, niet alleen erover praten. “Stuur een mail naar Tom dat de afspraak verschoven is” is voor een chatbot een verzoek om de mail-tekst op te stellen die jij vervolgens kopieert. Voor een agent kan dat een instructie zijn die hij zelf uitvoert, mits hij toegang heeft tot je mail-account.

Het tweede verschil: een agent onthoudt dingen tussen gesprekken door. Een chatbot vergeet bij elke nieuwe sessie. Een agent weet wat je vorige week hebt gevraagd, kent je voorkeuren, weet aan welke projecten je werkt. Dat geheugen is wat hem voelt als een digitale collega, niet als een tool.

Het derde verschil: een agent kan proactief zijn. Niet alleen reageren, maar zelf iets doen. Elke ochtend een briefing sturen, elke maandag een wekoverzicht schrijven, een herinnering geven wanneer je vergeten dreigt iets te doen.

Een AI-agent is dus: een AI met tools, geheugen en eigen tijd. Niet helemaal als een mens, maar in de buurt.

02 · WAAROM EEN EIGEN RUNTIME, NIET CHATGPTVoor wie OpenClaw is, en wanneer niet

ChatGPT en Claude.ai zijn fantastische AI-tools. Voor de meeste mensen voldoen ze. Waarom zou je dan iets ingewikkelders willen?

Drie redenen.

Je data blijft bij jou. OpenClaw draait op jouw machine. Jouw gesprekken, jouw bestanden, jouw geheugen leven op jouw disk. De enige data die de machine verlaat, is het korte stuk dat naar het LLM-model gaat voor het denkwerk. Voor mensen die werken met vertrouwelijke informatie (juridisch, medisch, financieel, persoonlijk) is dat een echt argument.

Je leeft niet in een aparte tab. OpenClaw zit in de messaging-apps waar je toch al bent: WhatsApp, Telegram, Discord, Signal, Slack. Je hebt geen aparte app nodig om met je AI te praten; je stuurt hem een bericht zoals je een collega bericht stuurt. Voor wie de hele dag schakelt tussen tools, scheelt dat veel context-verlies.

Je houdt zelf de regie. Welk model je gebruikt (Claude, GPT, Gemini, lokaal Llama), welke skills je activeert, welke kanalen je koppelt, hoe je geheugen werkt; allemaal jouw keuze. Bij ChatGPT en Claude.ai zit je vast aan wat de leverancier toelaat.

Voor wie is dit niet de juiste keuze? Voor wie incidenteel een vraag heeft en geen behoefte heeft aan continuïteit, is ChatGPT prima. Voor wie geen Docker wil draaien en niets wil configureren, ook. OpenClaw vereist enig comfort met de command-line en met technische keuzes. Het is niet voor iedereen, en dat is geen falen.

03 · DE ESSENTIE IN VIJF ZINNENWat OpenClaw fundamenteel is

Voor wie geen tijd heeft voor de hele fieldguide, hier is OpenClaw in vijf zinnen:

OpenClaw is een lokale runtime voor persoonlijke AI-agents, die je via je gewone messaging-apps aanstuurt.
Een agent is een claw met eigen persoonlijkheid, eigen geheugen, en toegang tot tools die hij namens jou gebruikt.
Alle data leeft op jouw machine; alleen de gesprekken met het LLM-model verlaten je netwerk.
De agent kan proactief werken via heartbeats en cron, niet alleen reactief op jouw vragen.
OpenClaw is gebouwd om met je mee te groeien: meer agents, meer skills, meer kanalen, zonder dat de architectuur erop hoeft te veranderen.

Wie deze vijf zinnen vasthoudt, kan elke pagina van de fieldguide herleiden tot iets dat hij al kent.

04 · DE DRIE DINGEN DIE JE NU MOET SNAPPENDe minimaal nodige mentale modellen

OpenClaw heeft elf primaire abstracties. Voor de start hoef je er drie te kennen: de andere acht komen vanzelf wanneer je tegen ze aanloopt.

Een claw is een individuele agent. Met een eigen naam, persoonlijkheid, geheugen en kanaalverbindingen. Eén OpenClaw-installatie kan meerdere claws tegelijk draaien (eentje voor werk, eentje voor thuis), maar je begint met één. Stel je hem voor als een hulp die jouw spullen kent.

Een channel is een verbinding met een messaging-platform. Telegram is een channel, WhatsApp is een channel, Slack is een channel. Eén claw kan op meerdere channels aanwezig zijn (zoals een persoon op meerdere telefoonnummers bereikbaar kan zijn). De claw weet via welk channel een bericht binnenkomt en stuurt zijn antwoord via dezelfde route terug.

Een skill is een herbruikbare vaardigheid. Een skill is een mapje met een markdown-bestand erin waarin staat wat de skill doet en hoe. “Stuur een mail” kan een skill zijn. “Lees mijn agenda” kan een skill zijn. “Maak een samenvatting van een PDF” kan een skill zijn. Je activeert skills, en de claw weet vanaf dat moment wanneer hij ze kan inzetten.

Met deze drie heb je de minimale mentale kaart: een claw (de agent) leeft in je channels (de communicatie) en kan skills uitvoeren (de acties). Alles wat in de fieldguide volgt is uitbouw op deze drie.

05 · DE FIELDGUIDE LEZENEen aanbevolen volgorde

De officiële fieldguide volgt een logische volgorde voor wie OpenClaw al installeert. Voor wie eerst wil begrijpen, is een andere route prettiger. Een aanbevolen leesvolgorde voor de eerste keer:

Eerst lezen (begrijpen van waar je naartoe werkt):

Wat OpenClaw eigenlijk is (introductie, ~10 min)
Wat een Claw uniek maakt (de vier kernwaarden: persoonlijkheid, geheugen, proactief, zelf uitbreiden)
Architectuur in het kort (de drie lagen, niet meer dan het overzicht)
Begrippen die je gaat tegenkomen (woordenlijst om bij de hand te hebben)

Pas lezen als je gaat installeren:

Deel 1: Installatie en eerste start
Deel 2: Security (lees voordat je verder gaat, niet erna)
Deel 3: Je eerste kanaal verbinden (begin met Telegram, niet met WhatsApp)
Deel 4: LLM-providers (kies één om mee te beginnen)

Lezen als je dieper wilt:

Deel 5: Personaliseren (SOUL.md, USER.md, MEMORY.md schrijven)
Deel 7: Skills (welke installeren, welke later)
Deel 6: Geheugen (hoe het werkt, wat de drie lagen zijn)

Voor later (kun je echt overslaan tot je het nodig hebt):

Deel 8: Meerdere kanalen tegelijk
Deel 9: Multi-agent
Deel 10: Geplande taken met cron
Deel 11: Browser-automatisering
Deel 13: Docker-sandboxing
Deel 14: Hooks en automatisering
Deel 15: Native apps

Het overige (CLI-referentie, configuratie-overzicht, troubleshooting, updaten) is reference: nodig wanneer je iets specifieks moet opzoeken, niet om door te lezen.

06 · WAT JE NOG NIET HOEFT TE SNAPPENOnderdelen die voor later mogen

Sommige onderdelen van OpenClaw zijn voor wie verder wil dan de eerste agent. Je hoeft ze niet vroeg te begrijpen.

Hooks. Hooks zijn handlers die op gebeurtenissen reageren (een bericht binnen, een sessie gestart, een mail ontvangen). Ze zijn krachtig maar conceptueel pittig. Voor je eerste setup: negeer.

Multi-agent en routing-regels. Meerdere claws op één installatie, elk met eigen workspace en kanalen. Pas relevant als je meer dan één duidelijk afgebakende context wilt. Begin met één.

Custom skill-development. Je eigen skills schrijven is leuk maar niet noodzakelijk. De ingebouwde skills en die van ClawHub voldoen voor het meeste.

Docker-sandboxing details. De default non-main mode is goed voor persoonlijk gebruik. Pas relevant als je een publieke bot wilt of met onbekende skills experimenteert.

Native app-integratie en device-capabilities. De iOS- en macOS-apps bieden camera, locatie, voice-modus, Apple Watch-koppeling. Allemaal optioneel. Voor de start hoef je ze niet te kennen.

Memory-wiki, active memory, dreaming, REM backfill. Geavanceerde geheugen-systemen. Voor de start zijn de drie geheugen-lagen genoeg (MEMORY.md, dagnotities, vector-index).

Dit klinkt als veel, maar het komt erop neer: OpenClaw is een uitgebreid systeem waarvan een klein deel volstaat voor de meeste gebruikers. Bouw uit waar je tegen grenzen aanloopt, niet voor de zekerheid.

07 · EERSTE STAPPEN NA DIT LEZENConcreet wat je nu kunt doen

Drie suggesties voor wat je hierna concreet zou kunnen doen, oplopend in commitment.

Optie 1: Eerst doorlezen op de Placebo-pagina. De Placebo Pill toont de complete fieldguide ongewijzigd. Lees de eerste drie secties (Wat OpenClaw is, Wat een Claw uniek maakt, Architectuur in het kort) om een vollediger beeld te krijgen voordat je iets installeert.

Optie 2: Kijk eerst door een andere lens. De Mental Pill geeft een conceptuele blauwdruk; goed voor wie het denkmodel scherp wil hebben voor de techniek begint. De Security Pill helpt om de risico-laag te begrijpen voordat je iets aansluit.

Optie 3: Begin met installeren. Volg de Build Pill, die de installatie als een gefaseerd doe-pad presenteert. Voor wie van doen leert: dit is de directe route. Reserveer ongeveer twee uur voor de eerste setup tot een werkende eerste agent.

Geen van deze drie is fout. De juiste keuze hangt af van hoe je leert: lees-eerst, begrijp-eerst of doe-eerst. OpenClaw zelf vergeeft alle volgordes.