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.

De ingebouwde engine is de standaardgeheugenbackend. Deze slaat je geheugenindex op in een SQLite-database per agent en heeft geen extra afhankelijkheden nodig om te beginnen.

​
Wat deze biedt

  • Trefwoordzoekopdrachten via FTS5-fulltextindexering (BM25-score).
  • Vectorzoekopdrachten via embeddings van elke ondersteunde provider.
  • Hybride zoekopdrachten die beide combineren voor de beste resultaten.
  • CJK-ondersteuning via trigram-tokenisatie voor Chinees, Japans en Koreaans.
  • sqlite-vec-versnelling voor vectorkwery’s in de database (optioneel).

​
Aan de slag

Als je een API-sleutel hebt voor OpenAI, Gemini, Voyage, Mistral of DeepInfra, detecteert de ingebouwde engine deze automatisch en schakelt vectorzoekopdrachten in. Geen configuratie nodig. Een provider expliciet instellen: 
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
      },
    },
  },
}
Zonder embeddingprovider is alleen trefwoordzoekopdracht beschikbaar. Om de ingebouwde lokale embeddingprovider te forceren, installeer je het optionele node-llama-cpp-runtimepakket naast OpenClaw en laat je local.modelPath naar een GGUF-bestand verwijzen: 
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "local",
        fallback: "none",
        local: {
          modelPath: "~/.node-llama-cpp/models/embeddinggemma-300m-qat-Q8_0.gguf",
        },
      },
    },
  },
}

​
Ondersteunde embeddingproviders

ProviderIDAutomatisch gedetecteerdOpmerkingen
OpenAIopenaiJaStandaard: text-embedding-3-small
GeminigeminiJaOndersteunt multimodaal (beeld + audio)
VoyagevoyageJa
MistralmistralJa
DeepInfradeepinfraJaStandaard: BAAI/bge-m3
OllamaollamaNeeLokaal, expliciet instellen
LocallocalJa (als eerste)Optionele node-llama-cpp-runtime
Automatische detectie kiest de eerste provider waarvan de API-sleutel kan worden gevonden, in de weergegeven volgorde. Stel memorySearch.provider in om dit te overschrijven.

​
Hoe indexering werkt

OpenClaw indexeert MEMORY.md en memory/*.md in chunks (~400 tokens met 80 tokens overlap) en slaat ze op in een SQLite-database per agent.
  • Indexlocatie: ~/.openclaw/memory/<agentId>.sqlite
  • Opslagonderhoud: SQLite WAL-sidecars worden begrensd met periodieke en afsluitcheckpoints.
  • Bestandsbewaking: wijzigingen in geheugenbestanden activeren een gedebouncete herindexering (1,5 s).
  • Automatisch herindexeren: wanneer de embeddingprovider, het model of de chunkingconfiguratie verandert, wordt de volledige index automatisch opnieuw opgebouwd.
  • Herindexeren op aanvraag: openclaw memory index --force
Je kunt ook Markdown-bestanden buiten de werkruimte indexeren met memorySearch.extraPaths. Zie de configuratiereferentie.

​
Wanneer te gebruiken

De ingebouwde engine is de juiste keuze voor de meeste gebruikers:
  • Werkt direct zonder extra afhankelijkheden.
  • Verwerkt trefwoord- en vectorzoekopdrachten goed.
  • Ondersteunt alle embeddingproviders.
  • Hybride zoekopdrachten combineren het beste van beide ophaalmethoden.
Overweeg over te stappen naar QMD als je reranking, query- uitbreiding nodig hebt, of mappen buiten de werkruimte wilt indexeren. Overweeg Honcho als je geheugen over sessies heen wilt met automatische gebruikersmodellering.

​
Problemen oplossen

Geheugenzoekopdracht uitgeschakeld? Controleer openclaw memory status. Als er geen provider wordt gedetecteerd, stel er dan expliciet een in of voeg een API-sleutel toe. Lokale provider niet gedetecteerd? Controleer of het lokale pad bestaat en voer uit: 
openclaw memory status --deep --agent main
openclaw memory index --force --agent main
Zowel zelfstandige CLI-opdrachten als de Gateway gebruiken dezelfde local-provider-ID. Als de provider is ingesteld op auto, worden lokale embeddings alleen als eerste overwogen wanneer memorySearch.local.modelPath naar een bestaand lokaal bestand verwijst. Verouderde resultaten? Voer openclaw memory index --force uit om opnieuw op te bouwen. De watcher kan in zeldzame randgevallen wijzigingen missen. sqlite-vec laadt niet? OpenClaw valt automatisch terug op in-process cosinusovereenkomst. Controleer de logs voor de specifieke laadfout.

​
Configuratie

Voor het instellen van embeddingproviders, het afstemmen van hybride zoekopdrachten (gewichten, MMR, temporeel verval), batchindexering, multimodaal geheugen, sqlite-vec, extra paden en alle andere configuratieknoppen, zie de Geheugenconfiguratiereferentie.

​
Gerelateerd