QMD-geheugenengine

​

Wat het toevoegt bovenop builtin

• Reranking en query-uitbreiding voor betere recall.
• Extra mappen indexeren — projectdocumentatie, teamnotities, alles op schijf.
• Sessietranscripten indexeren — haal eerdere gesprekken terug.
• Volledig lokaal — draait met de officiële llama.cpp provider-plugin en downloadt GGUF-modellen automatisch.
• Automatische fallback — als QMD niet beschikbaar is, valt OpenClaw naadloos terug op de builtin 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 collections op basis 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 in-process bestandssysteemcrawl. Semantische modi voeren ook qmd embed uit.
• De standaardwerkruimtecollection volgt MEMORY.md plus de memory/-boom. Kleine-letter memory.md wordt niet als rootgeheugenbestand geïndexeerd.
• QMD’s eigen scanner negeert verborgen paden en veelgebruikte afhankelijkheids-/buildmappen zoals .git, .cache, node_modules, vendor, dist en build. Gateway-opstart 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 QMD toch bij Gateway-start wilt initialiseren, stel dan memory.qmd.update.startup in op idle of immediate. Met memory.qmd.update.onBoot: true voert het opstarten de eerste vernieuwing uit. Met onBoot: false slaat het opstarten die directe vernieuwing over, maar opent het nog steeds de langlevende manager wanneer update- of embed-intervallen zijn geconfigureerd, zodat QMD zijn reguliere watcher en timers kan beheren.
• Zoekopdrachten gebruiken de geconfigureerde searchMode (standaard: search; ondersteunt ook vsearch en query). search is alleen BM25, dus OpenClaw slaat gereedheidsprobes voor semantische vectoren en embedding-onderhoud over in die modus. Als een modus faalt, probeert OpenClaw het opnieuw met qmd query.
• Wanneer searchMode query is, stel memory.qmd.rerank in op false om QMD’s hybride querypad zonder reranker te gebruiken. OpenClaw geeft --no-rerank door aan het directe QMD-CLI-pad en rerank: false aan QMD’s MCP-querytool. Deze optie vereist QMD 2.1 of nieuwer.
• Met QMD-releases die filters voor meerdere collections adverteren, groepeert OpenClaw collections met dezelfde bron in één QMD-zoekaanroep. Oudere QMD-releases behouden de compatibele fallback per collection.
• Als QMD volledig faalt, valt OpenClaw terug op de builtin SQLite-engine. Herhaalde pogingen tijdens chatbeurten wachten kort na een openingsfout, zodat een ontbrekende binary of kapotte sidecar-afhankelijkheid geen retrystorm veroorzaakt; openclaw memory status en eenmalige CLI-probes controleren QMD nog steeds direct 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

{
  agents: {
    defaults: {
      memorySearch: {
        experimental: { sessionMemory: true },
        sources: ["memory", "sessions"],
      },
    },
  },
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Zoekbereik

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

​

Citaten

​

Wanneer gebruiken

• Reranking voor resultaten van hogere kwaliteit.
• Projectdocumentatie of notities buiten de werkruimte doorzoeken.
• Eerdere sessiegesprekken terughalen.
• Volledig lokale zoekfunctie zonder API-sleutels.

​

Probleemoplossing

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

​

Configuratie

​

Gerelateerd

• Geheugenoverzicht
• Builtin geheugenengine
• Honcho-geheugen