​

QMD Memory Engine

​

Was es gegenüber der integrierten Lösung ergänzt

• Reranking und Query-Erweiterung für besseren Recall.
• Zusätzliche Verzeichnisse indizieren — Projektdokumentation, Teamnotizen, alles auf der Festplatte.
• Sitzungstranskripte indizieren — frühere Unterhaltungen wiederfinden.
• Vollständig lokal — läuft über Bun + node-llama-cpp, lädt GGUF-Modelle automatisch herunter.
• Automatischer Fallback — wenn QMD nicht verfügbar ist, wechselt OpenClaw nahtlos auf die integrierte Engine zurück.

​

Erste Schritte

​

Voraussetzungen

• QMD installieren: npm install -g @tobilu/qmd oder bun install -g @tobilu/qmd
• SQLite-Build, das Erweiterungen erlaubt (brew install sqlite auf macOS).
• QMD muss im PATH des Gateway vorhanden sein.
• macOS und Linux funktionieren sofort. Windows wird am besten über WSL2 unterstützt.

​

Aktivieren

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

​

So funktioniert der Sidecar

• OpenClaw erstellt Collections aus Ihren Workspace-Memory-Dateien und allen konfigurierten memory.qmd.paths, führt dann qmd update + qmd embed beim Start und regelmäßig aus (standardmäßig alle 5 Minuten).
• Die standardmäßige Workspace-Collection verfolgt MEMORY.md sowie den memory/- Baum. Kleingeschriebenes memory.md bleibt ein Bootstrap-Fallback, keine separate QMD- Collection.
• Die Aktualisierung beim Start läuft im Hintergrund, damit der Chat-Start nicht blockiert wird.
• Suchvorgänge verwenden den konfigurierten searchMode (Standard: search; unterstützt auch vsearch und query). Wenn ein Modus fehlschlägt, versucht OpenClaw es erneut mit qmd query.
• Wenn QMD vollständig fehlschlägt, greift OpenClaw auf die integrierte SQLite-Engine zurück.

​

Modell-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"

​

Zusätzliche Pfade indizieren

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

​

Sitzungstranskripte indizieren

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

​

Suchbereich

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

​

Zitate

​

Wann verwenden

• Reranking für höherwertige Ergebnisse.
• Suche in Projektdokumentation oder Notizen außerhalb des Workspace.
• Wiederfinden vergangener Sitzungsunterhaltungen.
• Vollständig lokale Suche ohne API-Schlüssel.

​

Fehlerbehebung

​

Konfiguration