​

Moteur de mémoire QMD

​

Ce qu’il ajoute par rapport au moteur intégré

• Reranking et expansion de requête pour une meilleure couverture.
• Indexer des répertoires supplémentaires — documentation de projet, notes d’équipe, tout ce qui se trouve sur le disque.
• Indexer les transcriptions de session — pour retrouver des conversations antérieures.
• Entièrement local — fonctionne via Bun + node-llama-cpp, télécharge automatiquement les modèles GGUF.
• Repli automatique — si QMD n’est pas disponible, OpenClaw revient au moteur intégré de manière transparente.

​

Prise en main

​

Prérequis

• Installer QMD : npm install -g @tobilu/qmd ou bun install -g @tobilu/qmd
• Une version de SQLite qui autorise les extensions (brew install sqlite sur macOS).
• QMD doit être présent dans le PATH de la passerelle.
• macOS et Linux fonctionnent immédiatement. Windows est mieux pris en charge via WSL2.

​

Activer

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

​

Fonctionnement du sidecar

• OpenClaw crée des collections à partir des fichiers de mémoire de votre espace de travail et de tous les memory.qmd.paths configurés, puis exécute qmd update + qmd embed au démarrage et périodiquement (par défaut toutes les 5 minutes).
• La collection d’espace de travail par défaut suit MEMORY.md ainsi que l’arborescence memory/. memory.md en minuscules reste une solution de secours d’amorçage, pas une collection QMD distincte.
• L’actualisation au démarrage s’exécute en arrière-plan afin de ne pas bloquer le démarrage du chat.
• Les recherches utilisent le searchMode configuré (par défaut : search ; prend aussi en charge vsearch et query). Si un mode échoue, OpenClaw réessaie avec qmd query.
• Si QMD échoue complètement, OpenClaw revient au moteur SQLite intégré.

​

Remplacement des modèles

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"

​

Indexation de chemins supplémentaires

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

​

Indexation des transcriptions de session

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

​

Portée de recherche

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

​

Citations

​

Quand l’utiliser

• Du reranking pour des résultats de meilleure qualité.
• De rechercher dans la documentation du projet ou des notes en dehors de l’espace de travail.
• De retrouver des conversations de sessions passées.
• D’une recherche entièrement locale sans clés d’API.

​

Dépannage

​

Configuration