Om OpenClaw beter te begrijpen ben ik eens gedoken in de architectuur en welke directories/files er allemaal aanwezig zijn. Op deze manier krijg ik een beter inzicht in de werking van OpenClaw.
Architectuur
OpenClaw maakt gebruik van een architectuur met vier lagen
- Gateway (Core Hub): het zenuwcentrum van het hele systeem, dat zorgt voor taakplanning, geheugenbeheer en het toewijzen van LLM’s, en draait op ws://127.0.0.1:18789. Alle commando’s komen uiteindelijk bij de Gateway terecht voor verwerking
- Nodes (hardwareknooppunten): zorgen voor de interactie met uw computerhardware – bestandssysteemoperaties, uitvoering van shell-opdrachten, procesbeheer. Ondersteunt macOS, Linux, Windows WSL2 en zelfs Raspberry Pi
- Channels (communicatiekanalen): koppelen WhatsApp, Telegram, Discord, Slack, Signal en meer dan 10 andere berichtenplatforms, zodat je via je dagelijkse chattools opdrachten aan de AI kunt geven
- Skills (Skill-modules): Uitbreidbare plug-ins – browserautomatisering, kalenderintegratie, uitvoering van code, blogmonitoring en meer. Via de Skills-marktplaats kun je de mogelijkheden van de AI voortdurend uitbreiden
Daarnaast is er een overkoepelende Memory Layer die je gesprekscontext en voorkeuren permanent opslaat in Markdown-bestandsformaat, waardoor OpenClaw je in de loop van de tijd steeds beter begrijpt.
Persistentie
Er zijn drie aanpassingen die het belangrijkste zijn. Als je alleen deze doorvoert dan ben je volgens informatie-bronnen op internet al beter dan 95% van de OpenClaw-gebruikers.
- Zet blijvende regels in bestanden, niet in de chat. Je MEMORY.md en AGENTS.md blijven behouden na het samenvoegen. Instructies die je in de chat typt, gaan verloren.
- Controleer of het leegmaken van het geheugen is ingeschakeld en of er voldoende buffer is om dit te activeren. OpenClaw heeft een ingebouwd vangnet dat de context opslaat vóór het opschonen, maar de meeste mensen controleren nooit of dit werkt of geven het niet genoeg ruimte om te activeren.
- Maak het ophalen van informatie verplicht. Voeg een regel toe aan AGENTS.md die zegt: “zoek in het geheugen voordat je handelt.” Zonder deze regel gaat de agent gissen in plaats van zijn aantekeningen te controleren.
Directory/File structuur
Files
De volgende files zijn belangrijk binnen de OpenClaw directories:
| execapprovals.json | Vastleggen toestemmingen voor agents. |
| openclaw.json | Belangrijkste configuratiebestand voor OpenClaw, fungeert als het “configuratiescherm” of het “kloppende hart” van het hele systeem en bepaalt hoe de AI-agent zich gedraagt, welke modellen hij gebruikt en hoe hij verbinding maakt met berichtenapps en lokale tools. |
| AGENTS.md | Bevat procedurele regels, workflowstappen en logica voor de coördinatie tussen meerdere agenten (“Wat je doet”). |
| BOOTSTRAP.md | Eenmalige instructieset – afhankelijkheden installeren, inloggegevens configureren, mappenstructuur instellen. |
| HEARTBEAT.md | Definieert terugkerende taken of “cron”-taken, zoals het controleren van logboeken of het verzenden van wekelijkse rapporten. |
| IDENTITY.md | Openbare informatie zoals de naam, ID en rol-labels van de agent. |
| MEMORY.md | Een samengesteld bestand met blijvende informatie die in alle sessies bewaard moet blijven. |
| SOUL.md | Bepaalt de toon, kernwaarden en gedragsgrenzen van de agent (“Wie je bent”). |
| TOOLS.md | Bevat beschikbare hulpmiddelen (browser, shell, enz.) en specifieke instructies voor het gebruik ervan. |
| USER.md | Informatie over de menselijke operator (voorkeuren, tijdzone, toegangsniveaus). |
Directories
In de ~/.openclaw directories kun je volgende sub-directories vinden:
| delivery-queue | Zorgt dat uitgaande berichten—zoals antwoorden van de AI-assistent—betrouwbaar worden verstuurd naar chatapps (WhatsApp, Telegram, Discord, etc.), zelfs als de verbinding tijdelijk wegvalt of als de agent “bezig” is. |
| devices | Opslagplaats voor cryptografische identiteitsgegevens van de verschillende apparaten en interfaces die verbinding maken met jouw OpenClaw-gateway. |
| identity | Kernconfiguratie en de “ziel” van een AI-agent. |
| logs | Bevat log-files van wat er allemaal gebeurt in OpenClaw. |
| media | Beveiligde map binnen de werkruimte van de AI-agent die wordt gebruikt voor het beheren van bestanden, zoals afbeeldingen, documenten en audio, die door de agent worden ontvangen of gegenereerd. |
| memory | Centrale opslagplaats voor de langetermijnherinneringen van een AI-agent. Het is een transparant systeem dat gebruikmaakt van platte Markdown-bestanden, waardoor de herinneringen door mensen leesbaar, bewerkbaar en doorzoekbaar zijn. |
| skills | Gecentraliseerde opslagplaats of “bibliotheek” van gespecialiseerde vaardigheden (skills) die je kunt toevoegen aan je AI-agent. Deze skills breiden de mogelijkheden van de agent uit, waardoor deze specifieke taken kan uitvoeren, zoals webonderzoek, bestandsbeheer, browserautomatisering of het versturen van berichten. |
| tasks | Gebruikt voor het beheren en inplannen van terugkerende acties en geautomatiseerde processen. |
| works | Centrale, lokale map op je computer waar de OpenClaw AI-agent al zijn gegevens opslaat, beheert en gebruikt. Het is de “thuishaven” van je assistent, waar je configuratiebestanden, gespreksgeschiedenis en aangepaste vaardigheden (skills) worden bewaard als Markdown- en YAML-bestanden. |
| workspace | Centrale locatie op je lokale computer of server waar alle configuratiebestanden, geheugen, vaardigheden (skills) en tijdelijke gegevens van de AI-agent worden opgeslagen. Het fungeert als het “brein” en de “persoonlijkheid” van de AI, waardoor de agent persistent gedrag vertoont over verschillende chatsessies heen. |
Skills
OpenClaw skills zijn specifieke, modulaire mogelijkheden of plug-ins die je toevoegt aan de OpenClaw AI-assistent om deze in staat te stellen actieve, echte taken uit te voeren. Waar de basis-AI vooral praat, zorgen skills ervoor dat de agent kan ‘handelen’, zoals het beheren van bestanden, surfen op het web of communiceren met andere software
Clawhub is de community-pakketbeheerder van OpenClaw voor het zoeken naar en met één klik installeren van diverse functionaliteitsmodules (skills). Je kunt hiermee zoeken naar skills en deze installeren.
# Search available Skills npx clawhub search naam_van_gewenste_skill
Om een Skill te installeren gebruik je:
openclaw skills install naam_van_skill
(deze worden geinstalleerd in ~/.openclaw/workspace/skills)
of
npx clawhub install naam_van_skill
(deze worden geinstalleerd in huidige directory in een skills sub-directory)
Meer informatie:
Op internet is ontzettend veel informate over OpenClaw te vinden. Ik vond de volgende links wel goed:
- OpenClaw Architecture, Explained
- OpenClaw Tutorial 2026: Complete Beginner to Advanced Guide
- OpenClaw Memory Masterclass: The complete guide to agent memory that survives
Verse start
Om OpenClaw te resetten en opnieuw te beginnen, voer je in de terminal het volgende commando uit:
openclaw reset --scope full --yes
Dit verwijdert de lokale configuraties, inloggegevens en sessiegegevens.
