QMD मेमोरी इंजन

​

अंतर्निहित इंजन की तुलना में अतिरिक्त सुविधाएँ

• बेहतर रिकॉल के लिए पुनःरैंकिंग और क्वेरी विस्तार।
• अतिरिक्त निर्देशिकाओं को इंडेक्स करें - प्रोजेक्ट दस्तावेज़, टीम नोट्स या डिस्क पर मौजूद कोई भी सामग्री।
• सत्र ट्रांसक्रिप्ट को इंडेक्स करें - पिछली बातचीत याद करें।
• पूरी तरह स्थानीय - आधिकारिक llama.cpp प्रदाता Plugin के साथ चलता है और GGUF मॉडल स्वतः डाउनलोड करता है।
• स्वचालित फ़ॉलबैक - यदि QMD उपलब्ध नहीं है, तो OpenClaw निर्बाध रूप से अंतर्निहित इंजन पर लौट जाता है।

​

आरंभ करना

​

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

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

​

सक्षम करें

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

​

सहायक प्रक्रिया कैसे काम करती है

• OpenClaw कार्यक्षेत्र की मेमोरी फ़ाइलों और कॉन्फ़िगर किए गए memory.qmd.paths से संग्रह बनाता है। QMD एडाप्टर अपडेट, एम्बेडिंग, डिबाउंस और टाइमआउट अनुमान का स्वामी है; ये उपयोगकर्ता कॉन्फ़िगरेशन नहीं हैं।
• QMD प्रति-एजेंट QMD होम के अंतर्गत अपने index.sqlite, YAML संग्रह कॉन्फ़िगरेशन और मॉडल डाउनलोड का स्वामी बना रहता है; ये बाहरी टूल की कलाकृतियाँ हैं, OpenClaw स्थिति तालिकाएँ नहीं। OpenClaw के स्वामित्व वाला समन्वय केवल SQLite में रहता है: एक साझा लीज़ सभी एजेंटों में एम्बेडिंग कार्य को सीमित करती है, जबकि प्रत्येक एजेंट डेटाबेस में एक लीज़ उस एजेंट के संग्रह, अपडेट और एम्बेड लेखनों को क्रमबद्ध करती है। रनटाइम अब QMD फ़ाइल-लॉक सहायक फ़ाइलें नहीं बनाता। openclaw doctor --fix पुरानी सहायक फ़ाइलों को तभी हटाता है, जब यह सिद्ध हो जाए कि उनका पुराना प्रक्रिया स्वामी निष्क्रिय है। अपग्रेड एक स्पष्ट कटओवर है: नया संस्करण उपयोग करने से पहले स्थिति निर्देशिका साझा करने वाली प्रत्येक OpenClaw प्रक्रिया को रोकें और पुनः आरंभ करें। पुराने और नए QMD लेखकों का मिश्रण समर्थित नहीं है; रनटाइम जानबूझकर पुरानी सहायक फ़ाइलों पर दोहरा लॉक नहीं लगाता।
• डिफ़ॉल्ट कार्यक्षेत्र संग्रह MEMORY.md और memory/ ट्री को ट्रैक करता है। छोटे अक्षरों वाला memory.md रूट मेमोरी फ़ाइल के रूप में इंडेक्स नहीं किया जाता।
• QMD का अपना स्कैनर छिपे हुए पथों और सामान्य निर्भरता/बिल्ड निर्देशिकाओं, जैसे .git, .cache, node_modules, vendor, dist और build, को अनदेखा करता है। Gateway स्टार्टअप QMD को आलसी रखता है; मेमोरी का पहली बार उपयोग होने पर प्रबंधक प्रारंभ होता है।
• खोजें कॉन्फ़िगर किए गए searchMode का उपयोग करती हैं (डिफ़ॉल्ट: search; साथ ही vsearch और query का समर्थन करती हैं)। search केवल BM25 है, इसलिए OpenClaw उस मोड में सिमेंटिक वेक्टर तत्परता जाँच और एम्बेडिंग रखरखाव छोड़ देता है। यदि कोई मोड विफल होता है, तो OpenClaw qmd query के साथ पुनः प्रयास करता है।
• जब searchMode, query हो, तो पुनःरैंकर के बिना QMD के हाइब्रिड क्वेरी पथ का उपयोग करने के लिए memory.qmd.rerank को false पर सेट करें (QMD 2.1 या नया संस्करण आवश्यक है)। OpenClaw सीधे QMD CLI पथ को --no-rerank और QMD के MCP क्वेरी टूल को rerank: false देता है।
• बहु-संग्रह फ़िल्टर का समर्थन घोषित करने वाले QMD रिलीज़ के साथ, OpenClaw समान-स्रोत संग्रहों को एक QMD खोज आह्वान में समूहित करता है। पुराने QMD रिलीज़ संगत प्रति-संग्रह फ़ॉलबैक बनाए रखते हैं।
• यदि QMD पूरी तरह विफल हो जाता है, तो OpenClaw अंतर्निहित SQLite इंजन पर लौट जाता है। ओपन विफलता के बाद बार-बार होने वाले चैट-टर्न प्रयास थोड़ी देर के लिए पीछे हटते हैं, ताकि अनुपस्थित बाइनरी या खराब सहायक प्रक्रिया निर्भरता पुनः प्रयासों का तूफ़ान न पैदा करे; openclaw memory status और एकबारगी CLI जाँच फिर भी सीधे QMD की पुनः जाँच करती हैं।

​

खोज प्रदर्शन और संगतता

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

qmd --help | grep -i collection

​

मॉडल ओवरराइड

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"

​

अतिरिक्त पथों को इंडेक्स करना

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

​

सत्र ट्रांसक्रिप्ट को इंडेक्स करना

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

​

खोज का दायरा

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

​

उद्धरण

​

कब उपयोग करें

• उच्च-गुणवत्ता वाले परिणामों के लिए पुनःरैंकिंग।
• कार्यस्थल के बाहर प्रोजेक्ट दस्तावेज़ या नोट्स खोजना।
• पिछले सत्रों की बातचीत याद करना।
• बिना API कुंजियों के पूरी तरह स्थानीय खोज।

​

समस्या निवारण

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

​

कॉन्फ़िगरेशन

​

संबंधित

• मेमोरी अवलोकन
• अंतर्निहित मेमोरी इंजन
• Honcho मेमोरी