QMD मेमोरी इंजन

​

यह builtin की तुलना में क्या जोड़ता है

• बेहतर recall के लिए पुनः-रैंकिंग और क्वेरी विस्तार।
• अतिरिक्त डायरेक्टरियां इंडेक्स करें — प्रोजेक्ट डॉक्स, टीम नोट्स, डिस्क पर कुछ भी।
• session transcripts इंडेक्स करें — पहले की बातचीत याद करें।
• पूरी तरह स्थानीय — आधिकारिक llama.cpp provider plugin के साथ चलता है और GGUF मॉडल अपने-आप डाउनलोड करता है।
• स्वचालित fallback — यदि QMD उपलब्ध नहीं है, तो OpenClaw बिना रुकावट अंतर्निहित इंजन पर वापस चला जाता है।

​

शुरू करना

​

पूर्वापेक्षाएं

• QMD इंस्टॉल करें: npm install -g @tobilu/qmd या bun install -g @tobilu/qmd
• ऐसा SQLite build जो extensions की अनुमति देता हो (macOS पर brew install sqlite)।
• QMD gateway के PATH पर होना चाहिए।
• macOS और Linux सीधे काम करते हैं। Windows के लिए WSL2 के माध्यम से सबसे अच्छा समर्थन है।

​

सक्षम करें

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

​

साइडकार कैसे काम करता है

• OpenClaw आपके workspace memory files और किसी भी configured memory.qmd.paths से collections बनाता है, फिर QMD manager खुलने पर और उसके बाद समय-समय पर (default हर 5 मिनट) qmd update चलाता है। ये refreshes QMD subprocesses के माध्यम से चलते हैं, in-process filesystem crawl से नहीं। Semantic modes qmd embed भी चलाते हैं।
• default workspace collection MEMORY.md और memory/ tree को track करता है। Lowercase memory.md root memory file के रूप में indexed नहीं होता।
• QMD का अपना scanner hidden paths और सामान्य dependency/build directories जैसे .git, .cache, node_modules, vendor, dist, और build को अनदेखा करता है। Gateway startup default रूप से QMD initialize नहीं करता, इसलिए cold boot memory के पहली बार उपयोग से पहले memory runtime import करने या long-lived watcher बनाने से बचता है।
• यदि आप फिर भी gateway start पर QMD initialized चाहते हैं, तो memory.qmd.update.startup को idle या immediate पर set करें। memory.qmd.update.onBoot: true के साथ, startup initial refresh चलाता है। onBoot: false के साथ, startup उस immediate refresh को skip करता है लेकिन update या embed intervals configured होने पर long-lived manager फिर भी खोलता है, ताकि QMD अपने regular watcher और timers own कर सके।
• Searches configured searchMode का उपयोग करती हैं (default: search; vsearch और query भी समर्थित हैं)। search केवल BM25 है, इसलिए OpenClaw उस mode में semantic vector readiness probes और embedding maintenance skip करता है। यदि कोई mode fail होता है, तो OpenClaw qmd query के साथ retry करता है।
• जब searchMode query हो, तो reranker के बिना QMD के hybrid query path का उपयोग करने के लिए memory.qmd.rerank को false पर set करें। OpenClaw direct QMD CLI path को --no-rerank और QMD के MCP query tool को rerank: false pass करता है। इस option के लिए QMD 2.1 या नया आवश्यक है।
• multi-collection filters advertise करने वाले QMD releases के साथ, OpenClaw same-source collections को एक QMD search invocation में group करता है। पुराने QMD releases compatible per-collection fallback रखते हैं।
• यदि QMD पूरी तरह fail हो जाता है, तो OpenClaw अंतर्निहित SQLite engine पर fallback करता है। Repeated chat-turn attempts open failure के बाद थोड़ी देर back off करते हैं ताकि missing binary या broken sidecar dependency retry storm न बनाए; openclaw memory status और one-shot CLI probes फिर भी QMD को सीधे recheck करते हैं।

​

खोज performance और compatibility

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"

​

अतिरिक्त paths इंडेक्स करना

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

​

Session transcripts इंडेक्स करना

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

​

Search scope

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

​

Citations

​

कब उपयोग करें

• higher-quality results के लिए पुनः-रैंकिंग।
• workspace के बाहर project docs या notes search करना।
• past session conversations recall करना।
• बिना API keys के पूरी तरह स्थानीय search।

​

Troubleshooting

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

​

Configuration

​

Related

• Memory overview
• Builtin memory engine
• Honcho memory