​

محرك ذاكرة QMD

​

ما الذي يضيفه مقارنة بالمحرك المدمج

• إعادة الترتيب وتوسيع الاستعلام لتحسين الاسترجاع.
• فهرسة أدلة إضافية — مستندات المشروع، وملاحظات الفريق، وأي شيء على القرص.
• فهرسة نصوص الجلسات — لاسترجاع المحادثات السابقة.
• محلي بالكامل — يعمل عبر Bun + node-llama-cpp، ويقوم بتنزيل نماذج GGUF تلقائيًا.
• احتياط تلقائي — إذا لم يكن QMD متاحًا، يعود OpenClaw إلى المحرك المدمج بسلاسة.

​

البدء

​

المتطلبات المسبقة

• ثبّت QMD: npm install -g @tobilu/qmd أو bun install -g @tobilu/qmd
• إصدار SQLite يسمح بالامتدادات (brew install sqlite على macOS).
• يجب أن يكون QMD موجودًا على PATH الخاص بالبوابة.
• يعمل macOS وLinux مباشرة. ويُدعَم Windows بأفضل شكل عبر WSL2.

​

التفعيل

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

​

كيف تعمل الخدمة الجانبية

• ينشئ OpenClaw مجموعات من ملفات ذاكرة مساحة العمل وأي memory.qmd.paths مُعدّة، ثم يشغّل qmd update و qmd embed عند الإقلاع وبشكل دوري (كل 5 دقائق افتراضيًا).
• يتم تنفيذ تحديث الإقلاع في الخلفية حتى لا يتم حظر بدء المحادثة.
• تستخدم عمليات البحث searchMode المُعدّ (الافتراضي: search؛ ويدعم أيضًا vsearch و query). إذا فشل وضع ما، يعيد OpenClaw المحاولة باستخدام qmd query.
• إذا فشل QMD بالكامل، يعود OpenClaw إلى محرك SQLite المدمج.

​

تجاوزات النموذج

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",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

نطاق البحث

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

​

الاستشهادات

​

متى تستخدمه

• إعادة الترتيب للحصول على نتائج أعلى جودة.
• البحث في مستندات المشروع أو الملاحظات خارج مساحة العمل.
• استرجاع محادثات الجلسات السابقة.
• بحث محلي بالكامل من دون مفاتيح API.

​

استكشاف الأخطاء وإصلاحها

​

الإعدادات