Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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).
Als je wilt dat je agent iets onthoudt, vraag het dan gewoon: “Onthoud dat ik TypeScript verkies.” Hij schrijft het naar het juiste bestand.

​
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.
OpenClaw detecteert je embeddingprovider automatisch op basis van beschikbare API-sleutels. Als je een OpenAI-, Gemini-, Voyage- of Mistral-sleutel hebt geconfigureerd, wordt geheugen zoeken automatisch ingeschakeld.
Zie voor details over hoe zoeken werkt, afstelopties en providerconfiguratie Geheugen zoeken.

​
Geheugenbackends

Ingebouwd (standaard)

Gebaseerd op SQLite. Werkt direct met trefwoordzoeken, vectorovereenkomst en hybride zoeken. Geen extra afhankelijkheden.

QMD

Local-first sidecar met reranking, query-uitbreiding en de mogelijkheid om mappen buiten de werkruimte te indexeren.

Honcho

AI-native geheugen tussen sessies met gebruikersmodellering, semantisch zoeken en multi-agent-bewustzijn. Plugin-installatie.

LanceDB

Meegeleverd door LanceDB ondersteund geheugen met OpenAI-compatibele embeddings, automatische recall, automatisch vastleggen en lokale Ollama-embeddingsupport.

​
Kenniswikilaag

Memory Wiki

Compileert duurzaam geheugen in een provenance-rijke wiki-kluis met claims, dashboards, bridge-modus en Obsidian-vriendelijke workflows.

​
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.
De geheugenflush voorkomt contextverlies tijdens Compaction. Als je agent belangrijke feiten in het gesprek heeft die nog niet naar een bestand zijn geschreven, worden ze automatisch opgeslagen voordat de samenvatting plaatsvindt.

​
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

​
Gerelateerd