Geheugenoverzicht

OpenClaw onthoudt dingen door gewone Markdown-bestanden te schrijven in de werkruimte 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. Wordt 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-items.

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

# Afgeleide verplichtingen

Sommige toekomstige follow-ups zijn geen duurzame feiten. Als je morgen een interview noemt, kan de nuttige herinnering zijn "na het interview informeren," niet "dit voor altijd opslaan in MEMORY.md."

Verplichtingen zijn opt-in, kortlevende follow-up-herinneringen 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 blijven geplande taken gebruiken.

# Geheugentools

De agent heeft twee tools om met geheugen te werken:

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

Beide tools worden geleverd door de Active Memory-Plugin (standaard: memory-core).

# Memory Wiki-begeleidende Plugin

Als je wilt dat duurzaam geheugen zich meer gedraagt als een onderhouden kennisbank dan als alleen 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 digests voor agent-/runtime-consumenten
• wiki-eigen tools zoals wiki_search, wiki_get, wiki_apply en wiki_lint

Het vervangt de Active Memory-Plugin niet. De Active Memory-Plugin blijft eigenaar van recall, promotie en dreaming. memory-wiki voegt ernaast een provenance-rijke kennislaag toe.

Zie Memory Wiki.

# Geheugen zoeken

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

Zie voor details over hoe zoeken werkt, afstelopties en providerconfiguratie Geheugen zoeken.

# Geheugenbackends

# Kenniswikilaag

# 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 modeloverride voor geheugenflush in om die huishoudelijke beurt 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 promoot alleen gekwalificeerde items naar langetermijngeheugen (MEMORY.md).

Het is ontworpen om langetermijngeheugen hoogwaardig te houden:

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

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

# Onderbouwde backfill en live promotie

Het dreaming-systeem heeft nu twee nauw verwante beoordelingslanen:

• Live dreaming werkt vanuit de kortetermijn-dreaming-store onder memory/.dreams/ en is wat de normale diepe fase gebruikt bij de beslissing wat naar MEMORY.md mag doorgroeien.
• 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 als duurzaam beschouwt zonder MEMORY.md handmatig te bewerken.

Wanneer je gebruikt:

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

worden de onderbouwde duurzame kandidaten niet direct gepromoot. Ze worden klaargezet in dezelfde kortetermijn-dreaming-store die de normale diepe fase al gebruikt. Dat betekent:

• DREAMS.md blijft het menselijke beoordelingsoppervlak.
• de kortetermijnstore blijft het machinegerichte rankingoppervlak.
• MEMORY.md wordt nog steeds alleen door diepe promotie geschreven.

Als je besluit dat de replay niet nuttig was, kun je de klaargezette artefacten verwijderen zonder gewone dagboekitems of normale recall-status aan te raken:

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

# CLI

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

# Verder lezen

• Ingebouwde geheugenengine: standaard SQLite-backend.
• QMD-geheugenengine: geavanceerde local-first sidecar.
• Honcho-geheugen: AI-native geheugen tussen sessies.
• Memory LanceDB: door LanceDB ondersteunde Plugin met OpenAI-compatibele embeddings.
• Memory Wiki: gecompileerde kenniskluis en wiki-eigen tools.
• Geheugen zoeken: zoekpipeline, providers en afstemming.
• Dreaming: achtergrondpromotie van kortetermijnrecall naar langetermijngeheugen.
• Referentie voor geheugenconfiguratie: alle configuratieknoppen.
• Compaction: hoe Compaction samenwerkt met geheugen.

# Gerelateerd

• Active Memory
• Geheugen zoeken
• Ingebouwde geheugenengine
• Honcho-geheugen
• Memory LanceDB
• Verplichtingen