Referentie voor geheugenconfiguratie

Deze pagina vermeldt elke configuratieoptie voor het doorzoeken van het geheugen van OpenClaw. Zie voor conceptuele overzichten:

Alle gedeelde geheugeninstellingen staan onder memory op het hoogste niveau in openclaw.json. Zoekstandaarden gebruiken memory.search; zoekspecifieke overschrijvingen per agent gebruiken agents.entries.*.memory.search.

Onthouden tussen gesprekken

Configureer dit per agent wanneer alleen een vertrouwde persoonlijke agent transcripten uit andere gesprekken mag ophalen:

{  agents: {    entries: {      personal: {        memory: {          search: {            rememberAcrossConversations: true,          },        },      },    },  },}

De waarde volgt de normale overerving van memory.search met een overschrijving per agent. Wanneer deze niet is ingesteld, is deze standaard alleen ingeschakeld als globale session.dmScope niet is ingesteld of "main" is en geen binding een overschrijving voor session.dmScope heeft. Elke geconfigureerde DM-isolatie schakelt deze standaard uit. Een expliciete true of false heeft altijd voorrang. Als dit wordt ingeschakeld, wordt sessietranscriptindexering geactiveerd en wordt sessions toegevoegd aan de opgeloste geheugenbronnen van de agent. Met QMD wordt ook de sessie-export van die agent ingeschakeld; voor deze modus is geen afzonderlijke instelling memory.qmd.sessions.enabled vereist.

De ingebouwde geheugenprovider van OpenClaw ondersteunt dit beveiligde pad met zowel de ingebouwde backend als de QMD-backend. Alternatieve geheugenproviders kunnen hun eigen ophaalhooks en geavanceerde Active Memory-tools blijven gebruiken, maar deze instelling wordt overgeslagen tenzij de huidige provider beveiligd ophalen van privétranscripten ondersteunt. openclaw doctor meldt een niet-ondersteunde provider of een expliciete Active Memory-lijst toolsAllow waarin memory_search ontbreekt.

De ophaalgrens is beperkter dan bij algemeen zoeken in sessies:

• alleen herkende privégesprekken van dezelfde agent komen in aanmerking
• het gesprek dat wordt beantwoord, wordt uitgesloten
• groepen en kanalen worden uitgesloten als bronnen en bestemmingen
• onbekende gesprekstypen worden standaard geweigerd
• ophalen in een sandbox kan de speciale autorisatie voor meerdere gesprekken niet gebruiken

De instelling wijzigt tools.sessions.visibility, sessiesleutels, transcriptopslag, afleveringsroutering of de machtigingen van sessions_list, sessions_history en sessions_send niet. Active Memory voert een begrensde alleen-lezen-ophaalronde uit; niet-beschikbaar of door een time-out afgebroken ophalen blokkeert het antwoord niet.

Providerselectie

Wanneer provider niet is ingesteld, gebruikt OpenClaw embeddings van OpenAI. Stel provider expliciet in om Bedrock, DeepInfra, Gemini, GitHub Copilot, Mistral, Ollama, Voyage, een lokaal GGUF-model of een OpenAI-compatibel /v1/embeddings-eindpunt te gebruiken. Verouderde configuraties die nog provider: "auto" vermelden, worden omgezet naar openai.

Wanneer provider niet is ingesteld, de verouderde provider: "auto" aanwezig is, of provider: "none" bewust de modus met alleen FTS selecteert, kan het ophalen uit het geheugen nog steeds lexicale FTS-rangschikking gebruiken wanneer embeddings niet beschikbaar zijn.

Expliciete niet-lokale providers worden standaard geweigerd. Als je memory.search.provider instelt op een concrete provider met een externe backend, zoals Bedrock, DeepInfra, Gemini, GitHub Copilot, LM Studio, Mistral, Ollama, OpenAI, Voyage of een OpenAI-compatibele aangepaste provider, en die provider tijdens runtime niet beschikbaar is, retourneert memory_search een resultaat dat aangeeft dat deze niet beschikbaar is, in plaats van stilzwijgend alleen FTS-ophalen te gebruiken. Herstel de provider-/authenticatieconfiguratie, schakel over naar een bereikbare provider of stel provider: "none" in als je bewust alleen FTS wilt gebruiken voor het ophalen.

Aangepaste provider-ID's

memory.search.provider kan verwijzen naar een aangepaste models.providers.<id>-vermelding voor geheugenspecifieke provideradapters zoals ollama, of voor OpenAI-compatibele model-API's zoals openai-responses / openai-completions. OpenClaw bepaalt de eigenaar van api van die provider voor de embeddingadapter, terwijl de aangepaste provider-ID behouden blijft voor de verwerking van eindpunten, authenticatie en modelvoorvoegsels. Hierdoor kunnen opstellingen met meerdere GPU's of hosts geheugenembeddings aan een specifiek lokaal eindpunt toewijzen:

{  models: {    providers: {      "ollama-5080": {        api: "ollama",        baseUrl: "http://gpu-box.local:11435",        apiKey: "ollama-local",        models: [{ id: "qwen3-embedding:0.6b", name: "Qwen3 Embedding 0.6B" }],      },    },  },  memory: {    search: {      provider: "ollama-5080",      model: "qwen3-embedding:0.6b",    },  },}

API-sleutel bepalen

Externe embeddings vereisen een API-sleutel. Bedrock gebruikt in plaats daarvan de standaardreferentieketen van de AWS SDK (instancerollen, SSO, toegangssleutels of een Bedrock-API-sleutel).

Configuratie van extern eindpunt

Gebruik provider: "openai-compatible" voor een generieke OpenAI-compatibele /v1/embeddings-server die geen globale OpenAI-chatreferenties mag overnemen.

{  memory: {    search: {      provider: "openai-compatible",      model: "text-embedding-3-small",      remote: {        baseUrl: "https://api.example.com/v1/",        apiKey: "YOUR_KEY",      },    },  },}

Providerspecifieke configuratie

{  memory: {    search: {      provider: "openai-compatible",      remote: {        baseUrl: "https://embeddings.example/v1",        apiKey: "${EMBEDDINGS_API_KEY}",      },      model: "asymmetric-embedder",      queryInputType: "query",      documentInputType: "passage",    },  },}

{  memory: {    search: {      provider: "bedrock",      model: "amazon.titan-embed-text-v2:0",    },  },}

{  "Effect": "Allow",  "Action": "bedrock:InvokeModel",  "Resource": "*"}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent mainopenclaw memory index --force --agent main

Indexeringsgedrag

Geheugenengines beheren synchronisatie, batchverwerking, bewaking en heuristieken voor indexering na Compaction. OpenClaw houdt dit gedrag ingeschakeld met onderhouden standaardwaarden in plaats van tijdschakelaars per installatie beschikbaar te stellen.

Configuratie voor hybride zoeken

Alles onder memory.search.query:

Hybride opvraging blijft ingeschakeld; MMR en tijdsverval blijven uitgeschakeld door het ingebouwde enginebeleid.

Volledig voorbeeld

{  memory: {    search: {      query: {        maxResults: 6,        minScore: 0.35,      },    },  },}

Aanvullende geheugenpaden

{  memory: {    search: {      extraPaths: ["../team-docs", "/srv/shared-notes"],    },  },}

Paden kunnen absoluut of relatief ten opzichte van de werkruimte zijn. Mappen worden recursief gescand op .md-bestanden. De afhandeling van symbolische koppelingen hangt af van de actieve backend: de ingebouwde engine slaat symbolische koppelingen over, terwijl QMD het gedrag van de onderliggende QMD-scanner volgt.

Gebruik voor agentgebonden zoekopdrachten in transcripties van andere agents agents.entries.*.memory.search.qmd.extraCollections in plaats van memory.qmd.paths. Die aanvullende verzamelingen volgen dezelfde { path, name, pattern? }-structuur, maar worden per agent samengevoegd en kunnen expliciete gedeelde namen behouden wanneer het pad buiten de huidige werkruimte wijst. Als hetzelfde opgeloste pad zowel in memory.qmd.paths als in memory.search.qmd.extraCollections voorkomt, behoudt QMD de eerste vermelding en slaat het duplicaat over.

Multimodaal geheugen (Gemini)

Indexeer afbeeldingen en audio naast Markdown met Gemini Embedding 2:

Ondersteunde indelingen: .jpg, .jpeg, .png, .webp, .gif, .heic, .heif (afbeeldingen); .mp3, .wav, .ogg, .opus, .m4a, .aac, .flac (audio).

Embeddingcache

Voorkomt dat ongewijzigde tekst opnieuw wordt ingebed tijdens herindexering of transcriptupdates.

Batchindexering

Beschikbaar voor gemini, openai en voyage. OpenAI-batchverwerking is doorgaans het snelst en goedkoopst voor grote aanvullingen met historische gegevens.

Gelijktijdigheid, polling en time-outgedrag worden door de provider beheerd.

Zoeken in sessiegeheugen

Indexeer sessietranscripties en maak ze beschikbaar via memory_search:

Gewone, door het model aangeroepen zoekopdrachten in sessietranscripten volgen tools.sessions.visibility. De standaardzichtbaarheid tree maakt de huidige sessie zichtbaar, evenals sessies die hierdoor zijn gestart en groepssessies van dezelfde agent die via omgevingsbewustzijn van groepen worden gevolgd. Voor andere, niet-gerelateerde sessies is zichtbaarheid agent vereist (of all alleen wanneer herinneringen tussen agents ook vereist zijn en het agent-naar-agentbeleid dit toestaat).

rememberAcrossConversations verruimt die instelling niet. Het biedt een afzonderlijke, uitsluitend voor runtime geldende autorisatie die tijdens de begrensde Active Memory-pass beperkt is tot privétranscripten van dezelfde agent.

In de onderstaande voorbeelden staan deze instellingen onder memory.search op het hoogste niveau. Je kunt ook gelijkwaardige instellingen toepassen in een memory.search-override per agent wanneer slechts één agent sessietranscripten moet indexeren en doorzoeken.

Voor herinneringen van dezelfde agent van gateway naar DM:

{  memory: {    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },  },  tools: {    sessions: { visibility: "agent" },  },}

{  memory: {    backend: "qmd",    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },    qmd: {      sessions: { enabled: true },    },  },  tools: {    sessions: { visibility: "agent" },  },}

Bij gebruik van QMD exporteert sources: ["sessions"] op zichzelf geen transcripten naar QMD. Stel ook memory.qmd.sessions.enabled: true in. De instelling op hoger niveau rememberAcrossConversations: true vormt de uitzondering: deze impliceert de vereiste export van QMD-sessies voor die agent. Impliciete exports blijven privé: ze gebruiken altijd de standaard interne exportlocatie (een geconfigureerde sessions.exportDir geldt alleen voor expliciete exports), worden alleen doorzocht tijdens de herinneringen tussen gesprekken van die agent en gewone memory_get kan ze niet lezen. Expliciete memory.qmd.sessions.enabled: true behoudt het bestaande gedrag en maakt geëxporteerde transcripten onderdeel van de gewone geheugencorpus.

SQLite-vectorversnelling (sqlite-vec)

Wanneer sqlite-vec niet beschikbaar is, valt OpenClaw automatisch terug op cosinusgelijkenis binnen het proces.

Indexopslag

Ingebouwde geheugenindexen staan in de OpenClaw SQLite-database van elke agent op agents/<agentId>/agent/openclaw-agent.sqlite.

Configuratie van de QMD-backend

Stel memory.backend = "qmd" in om deze in te schakelen. Alle QMD-instellingen staan onder memory.qmd:

searchMode: "search" is uitsluitend lexicaal/BM25. OpenClaw voert voor die modus geen gereedheidscontroles voor semantische vectoren of onderhoud van QMD-embeddings uit, ook niet tijdens memory status --deep; vsearch en query blijven QMD-vectorgereedheid en embeddings vereisen.

rerank: false wijzigt alleen de QMD-query-modus en vereist QMD 2.1 of nieuwer. In directe CLI-modus geeft OpenClaw --no-rerank door; in door mcporter ondersteunde MCP-modus geeft het rerank: false door aan QMD's uniforme querytool. Laat dit oningesteld om het standaardgedrag van QMD voor het herrangschikken van query's te gebruiken.

OpenClaw geeft de voorkeur aan actuele QMD-collectie- en MCP-querystructuren, maar houdt oudere QMD-releases werkend door waar nodig compatibele vlaggen voor collectiepatronen en oudere MCP-toolnamen te proberen. Wanneer QMD ondersteuning voor meerdere collectiefilters aangeeft, worden collecties met dezelfde bron met één QMD-proces doorzocht; oudere QMD-builds behouden het compatibiliteitspad per collectie. Dezelfde bron betekent dat duurzame geheugencollecties (standaardgeheugenbestanden plus aangepaste paden) samen worden gegroepeerd, terwijl collecties met sessietranscripten een afzonderlijke groep blijven, zodat brondiversificatie nog steeds beide invoerbronnen heeft.

{  memory: {    qmd: {      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },    },  },}

QMD wordt lui geïnitialiseerd wanneer het geheugen voor het eerst wordt gebruikt; de adapter beheert de vernieuwings- en embeddingschema's.

Volledig QMD-voorbeeld

{  memory: {    backend: "qmd",    citations: "auto",    qmd: {      includeDefaultMemory: true,      update: { interval: "5m", debounceMs: 15000 },      limits: { maxResults: 4, timeoutMs: 4000 },      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],    },  },}

Dreaming

Dreaming wordt geconfigureerd onder plugins.entries.memory-core.config.dreaming, niet onder memory.search.

Dreaming wordt uitgevoerd als één geplande controlecyclus en gebruikt interne lichte/diepe/REM-fasen als implementatiedetail.

Zie Dreaming voor conceptueel gedrag en slash-opdrachten.

Gebruikersinstellingen

Voorbeeld

{  plugins: {    entries: {      "memory-core": {        subagent: {          allowModelOverride: true,          allowedModels: ["anthropic/claude-sonnet-4-6"],        },        config: {          dreaming: {            enabled: true,            frequency: "0 3 * * *",            model: "anthropic/claude-sonnet-4-6",          },        },      },    },  },}

Gerelateerd

• Configuratiereferentie
• Geheugenoverzicht
• Geheugen doorzoeken