QMD-geheugenengine

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.

​

Wat het toevoegt ten opzichte van de ingebouwde engine

• Herrangschikken en query-uitbreiding voor betere recall.
• Extra mappen indexeren — projectdocumentatie, teamnotities, alles op schijf.
• Sessietranscripten indexeren — haal eerdere gesprekken op.
• Volledig lokaal — draait met het optionele node-llama-cpp-runtimepakket en downloadt GGUF-modellen automatisch.
• Automatische fallback — als QMD niet beschikbaar is, valt OpenClaw naadloos terug op de ingebouwde engine.

​

Aan de slag

​

Vereisten

• Installeer QMD: npm install -g @tobilu/qmd of bun install -g @tobilu/qmd
• SQLite-build die extensies toestaat (brew install sqlite op macOS).
• QMD moet op de PATH van de Gateway staan.
• macOS en Linux werken direct. Windows wordt het best ondersteund via WSL2.

​

Inschakelen

{
  memory: {
    backend: "qmd",
  },
}

​

Hoe de sidecar werkt

• OpenClaw maakt collecties van je werkruimtegeheugenbestanden en eventuele geconfigureerde memory.qmd.paths, en voert daarna qmd update uit wanneer de QMD-manager wordt geopend en periodiek daarna (standaard elke 5 minuten). Deze vernieuwingen lopen via QMD-subprocessen, niet via een filesystem-crawl binnen het proces. Semantische modi voeren ook qmd embed uit.
• De standaardwerkruimtecollectie volgt MEMORY.md plus de memory/-boom. memory.md in kleine letters wordt niet geïndexeerd als rootgeheugenbestand.
• QMD’s eigen scanner negeert verborgen paden en gangbare afhankelijkheids- en buildmappen zoals .git, .cache, node_modules, vendor, dist en build. Het opstarten van de Gateway initialiseert QMD standaard niet, zodat een koude start voorkomt dat de geheugenruntime wordt geïmporteerd of de langlevende watcher wordt aangemaakt voordat geheugen voor het eerst wordt gebruikt.
• Als je toch een vernieuwing bij Gateway-start wilt, stel dan memory.qmd.update.startup in op idle of immediate. De opt-in opstartvernieuwing gebruikt een eenmalig QMD-subprocespad in plaats van de volledige langlevende watcher binnen het proces aan te maken.
• Zoekopdrachten gebruiken de geconfigureerde searchMode (standaard: search; ondersteunt ook vsearch en query). search is alleen BM25, dus OpenClaw slaat probes voor semantische vectorgereedheid en embedding-onderhoud over in die modus. Als een modus faalt, probeert OpenClaw opnieuw met qmd query.
• Met QMD-releases die multi-collectiefilters adverteren, groepeert OpenClaw collecties met dezelfde bron in één QMD-zoekaanroep. Oudere QMD-releases behouden de compatibele fallback per collectie.
• Als QMD volledig faalt, valt OpenClaw terug op de ingebouwde SQLite-engine. Herhaalde pogingen tijdens chatbeurten krijgen kortstondig back-off na een openfout, zodat een ontbrekende binary of kapotte sidecar-afhankelijkheid geen retry-storm veroorzaakt; openclaw memory status en eenmalige CLI-probes controleren QMD nog steeds rechtstreeks opnieuw.

​

Zoekprestaties en compatibiliteit

qmd search "router notes" --json -n 10 -c memory-root-main -c memory-dir-main

qmd --help | grep -i collection

​

Model-overrides

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"
export QMD_RERANK_MODEL="/absolute/path/to/reranker.gguf"
export QMD_GENERATE_MODEL="/absolute/path/to/generator.gguf"

​

Extra paden indexeren

{
  memory: {
    backend: "qmd",
    qmd: {
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

Sessietranscripten indexeren

{
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Zoekscope

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

​

Citaten

​

Wanneer gebruiken

• Herrangschikken voor resultaten van hogere kwaliteit.
• Projectdocumentatie of notities buiten de werkruimte doorzoeken.
• Eerdere sessiegesprekken ophalen.
• Volledig lokaal zoeken zonder API-sleutels.

​

Probleemoplossing

{
  memory: {
    backend: "qmd",
    qmd: {
      command: "/absolute/path/to/qmd",
    },
  },
}

​

Configuratie

​

Gerelateerd

• Geheugenoverzicht
• Ingebouwde geheugenengine
• Honcho-geheugen