Geheugenoverzicht

OpenClaw onthoudt dingen door platte Markdown-bestanden te schrijven in de workspace van je agent. Het model "onthoudt" alleen wat op schijf wordt opgeslagen — er is geen verborgen status.

Hoe het werkt

Je agent heeft drie geheugengerelateerde bestanden:

• MEMORY.md — langetermijngeheugen. Duurzame feiten, voorkeuren en beslissingen. Geladen aan het begin van elke DM-sessie.
• memory/YYYY-MM-DD.md — dagelijkse notities. Doorlopende context en observaties. De notities van vandaag en gisteren worden automatisch geladen.
• DREAMS.md (optioneel) — Dream Diary en samenvattingen van dreaming-sweeps voor menselijke beoordeling, inclusief onderbouwde historische backfill-vermeldingen.

Deze bestanden staan in de agent-workspace (standaard ~/.openclaw/workspace).

Wat waar hoort

MEMORY.md is de compacte, beheerde laag. Gebruik het voor duurzame feiten, voorkeuren, vaste beslissingen en korte samenvattingen die beschikbaar moeten zijn aan het begin van een hoofd-privésessie. Het is niet bedoeld als ruwe transcriptie, dagelijks logboek of uitputtend archief.

memory/YYYY-MM-DD.md-bestanden zijn de werklaag. Gebruik ze voor gedetailleerde dagelijkse notities, observaties, sessiesamenvattingen en ruwe context die later nog nuttig kan zijn. Deze bestanden worden geïndexeerd voor memory_search en memory_get, maar ze worden niet bij elke beurt in de normale bootstrap-prompt geïnjecteerd.

Na verloop van tijd wordt verwacht dat de agent nuttig materiaal uit dagelijkse notities destilleert naar MEMORY.md en verouderde langetermijnvermeldingen verwijdert. De gegenereerde workspace-instructies en Heartbeat-flow kunnen dat periodiek doen; je hoeft MEMORY.md niet handmatig te bewerken voor elk onthouden detail.

Als MEMORY.md boven het budget voor bootstrap-bestanden groeit, houdt OpenClaw het bestand op schijf intact, maar kapt de kopie af die in de modelcontext wordt geïnjecteerd. Zie dat als een signaal om gedetailleerd materiaal terug te verplaatsen naar memory/*.md, alleen de duurzame samenvatting in MEMORY.md te bewaren, of de bootstrap-limieten te verhogen als je expliciet meer promptbudget wilt besteden. Gebruik /context list, /context detail of openclaw doctor om ruwe versus geïnjecteerde groottes en afkapstatus te zien.

Afgeleide toezeggingen

Sommige toekomstige opvolgingen zijn geen duurzame feiten. Als je morgen een sollicitatiegesprek noemt, kan de nuttige herinnering zijn: "navragen na het gesprek", niet "dit voor altijd opslaan in MEMORY.md."

Commitments zijn opt-in, kortlevende opvolgherinneringen voor dat geval. OpenClaw leidt ze af in een verborgen achtergrondpass, beperkt ze tot dezelfde agent en hetzelfde kanaal, en levert verschuldigde check-ins via Heartbeat. Expliciete herinneringen gebruiken nog steeds geplande taken.

Geheugentools

De agent heeft twee tools om met geheugen te werken:

• memory_search — vindt relevante notities met semantisch zoeken, zelfs wanneer de formulering afwijkt van het origineel.
• memory_get — leest een specifiek geheugenbestand of regelbereik.

Beide tools worden geleverd door de actieve geheugenplugin (standaard: memory-core).

Memory Wiki-begeleidende plugin

Als je wilt dat duurzaam geheugen zich meer gedraagt als een onderhouden kennisbank dan alleen als ruwe notities, gebruik dan de meegeleverde memory-wiki-plugin.

memory-wiki compileert duurzame kennis in een wiki-kluis met:

• deterministische paginastructuur
• gestructureerde claims en bewijs
• tracking van tegenstrijdigheden en actualiteit
• gegenereerde dashboards
• gecompileerde samenvattingen voor agent-/runtime-consumenten
• wiki-native tools zoals wiki_search, wiki_get, wiki_apply en wiki_lint

Het vervangt de actieve geheugenplugin niet. De actieve geheugenplugin blijft eigenaar van ophalen, promotie en Dreaming. memory-wiki voegt er een kennislaag met rijke herkomstgegevens naast toe.

Zie Memory Wiki.

Geheugen zoeken

Wanneer een embedding-provider is geconfigureerd, gebruikt memory_search hybride zoeken — een combinatie van vectorovereenkomst (semantische betekenis) en trefwoordmatching (exacte termen zoals ID's en codesymbolen). Dit werkt direct zodra je een API-sleutel hebt voor een ondersteunde provider.

Zie Memory Search voor details over hoe zoeken werkt, afstemmingsopties en providerinstelling.

Geheugenbackends

Kenniswiki-laag

Automatische geheugenflush

Voordat Compaction je gesprek samenvat, voert OpenClaw een stille beurt uit die de agent eraan herinnert belangrijke context op te slaan in geheugenbestanden. Dit staat standaard aan — je hoeft niets te configureren.

Stel een exacte model-override voor geheugenflush in om die onderhoudsbeurt op een lokaal model te houden:

{  "agents": {    "defaults": {      "compaction": {        "memoryFlush": {          "model": "ollama/qwen3:8b"        }      }    }  }}

De override geldt alleen voor de geheugenflush-beurt en erft de fallbackketen van de actieve sessie niet.

Dreaming

Dreaming is een optionele achtergrondconsolidatiepass voor geheugen. Het verzamelt kortetermijnsignalen, scoort kandidaten en promoveert alleen gekwalificeerde items naar langetermijngeheugen (MEMORY.md).

Het is ontworpen om langetermijngeheugen zeer signaalrijk te houden:

• Opt-in: standaard uitgeschakeld.
• Gepland: wanneer ingeschakeld, beheert memory-core automatisch één terugkerende cronjob voor een volledige dreaming-sweep.
• Met drempels: promoties moeten slagen voor score-, ophaalfrequentie- en querydiversiteitsgates.
• Beoordeelbaar: fasesamenvattingen en dagboekvermeldingen worden naar DREAMS.md geschreven voor menselijke beoordeling.

Zie Dreaming voor fasegedrag, scoringssignalen en details over Dream Diary.

Onderbouwde backfill en live promotie

Het dreamingsysteem heeft nu twee nauw verwante beoordelingslanen:

• Live dreaming werkt vanuit de kortetermijn-dreamingstore onder memory/.dreams/ en is wat de normale diepe fase gebruikt wanneer wordt besloten wat naar MEMORY.md kan promoveren.
• Onderbouwde backfill leest historische memory/YYYY-MM-DD.md-notities als zelfstandige dagbestanden en schrijft gestructureerde beoordelingsoutput naar DREAMS.md.

Onderbouwde backfill is nuttig wanneer je oudere notities opnieuw wilt afspelen en wilt inspecteren wat het systeem duurzaam vindt zonder MEMORY.md handmatig te bewerken.

Wanneer je dit gebruikt:

openclaw memory rem-backfill --path ./memory --stage-short-term

worden de onderbouwde duurzame kandidaten niet rechtstreeks gepromoveerd. Ze worden klaargezet in dezelfde kortetermijn-dreamingstore die de normale diepe fase al gebruikt. Dat betekent:

• DREAMS.md blijft het oppervlak voor menselijke beoordeling.
• de kortetermijnstore blijft het rangschikkingsoppervlak voor de machine.
• MEMORY.md wordt nog steeds alleen geschreven door diepe promotie.

Als je besluit dat de replay niet nuttig was, kun je de klaargezette artefacten verwijderen zonder gewone dagboekvermeldingen of normale ophaalstatus aan te raken:

openclaw memory rem-backfill --rollbackopenclaw memory rem-backfill --rollback-short-term

CLI

openclaw memory status          # Check index status and provideropenclaw memory search "query"  # Search from the command lineopenclaw memory index --force   # Rebuild the index

Verder lezen

• Ingebouwde geheugenengine: standaard SQLite-backend.
• QMD-geheugenengine: geavanceerde local-first sidecar.
• Honcho-geheugen: AI-native cross-sessiegeheugen.
• Memory LanceDB: LanceDB-onderbouwde plugin met OpenAI-compatibele embeddings.
• Memory Wiki: gecompileerde kennisvault en wiki-native tools.
• Memory search: zoekpipeline, providers en afstemming.
• Dreaming: achtergrondpromotie van kortetermijnherinnering naar langetermijngeheugen.
• Referentie voor geheugenconfiguratie: alle configuratieknoppen.
• Compaction: hoe Compaction samenwerkt met geheugen.

Gerelateerd

• Active Memory
• Memory search
• Ingebouwde geheugenengine
• Honcho-geheugen
• Memory LanceDB
• Commitments