Sessions and memory
محرك الذاكرة المضمّن
المحرك المدمج هو خلفية الذاكرة الافتراضية. يخزّن فهرس الذاكرة في قاعدة بيانات SQLite لكل وكيل ولا يحتاج إلى أي اعتماديات إضافية للبدء.
ما الذي يوفّره
- البحث بالكلمات المفتاحية عبر فهرسة النص الكامل FTS5 (تسجيل BM25).
- البحث المتجهي عبر التضمينات من أي مزوّد مدعوم.
- البحث الهجين الذي يجمع بينهما للحصول على أفضل النتائج.
- دعم CJK عبر تجزئة ثلاثية للغات الصينية واليابانية والكورية.
- تسريع sqlite-vec لاستعلامات المتجهات داخل قاعدة البيانات (اختياري).
البدء
بشكل افتراضي، يستخدم المحرك المدمج تضمينات OpenAI. إذا كان لديك بالفعل
OPENAI_API_KEY أو models.providers.openai.apiKey مضبوطًا، فسيعمل البحث
المتجهي من دون أي إعداد إضافي للذاكرة.
لتعيين مزوّد صراحةً:
{ agents: { defaults: { memorySearch: { provider: "openai", }, }, },}من دون مزوّد تضمينات، لا يتوفر إلا البحث بالكلمات المفتاحية.
لفرض تضمينات GGUF محلية، ثبّت Plugin مزوّد llama.cpp الرسمي،
ثم وجّه local.modelPath إلى ملف GGUF:
openclaw plugins install @openclaw/llama-cpp-provider{ agents: { defaults: { memorySearch: { provider: "local", fallback: "none", local: { modelPath: "~/.node-llama-cpp/models/embeddinggemma-300m-qat-Q8_0.gguf", }, }, }, },}مزوّدو التضمينات المدعومون
| المزوّد | المعرّف | ملاحظات |
|---|---|---|
| Bedrock | bedrock |
يستخدم سلسلة بيانات اعتماد AWS |
| DeepInfra | deepinfra |
الافتراضي: BAAI/bge-m3 |
| Gemini | gemini |
يدعم الوسائط المتعددة (صورة + صوت) |
| GitHub Copilot | github-copilot |
يستخدم اشتراك Copilot |
| محلي | local |
@openclaw/llama-cpp-provider |
| Mistral | mistral |
|
| Ollama | ollama |
محلي/مستضاف ذاتيًا |
| OpenAI | openai |
الافتراضي: text-embedding-3-small |
| متوافق مع OpenAI | openai-compatible |
نقطة نهاية /v1/embeddings عامة |
| Voyage | voyage |
عيّن memorySearch.provider للتبديل بعيدًا عن OpenAI.
كيف تعمل الفهرسة
يفهرس OpenClaw الملف MEMORY.md وملفات memory/*.md في مقاطع (~400 رمز مع
تداخل 80 رمزًا) ويخزّنها في قاعدة بيانات SQLite لكل وكيل.
- موقع الفهرس: قاعدة بيانات الوكيل المالك في
~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite - صيانة التخزين: تُقيَّد ملفات SQLite WAL الجانبية بنقاط تحقق دورية وعند إيقاف التشغيل.
- مراقبة الملفات: تؤدي التغييرات في ملفات الذاكرة إلى إعادة فهرسة مؤجلة (1.5 ثانية).
- إعادة الفهرسة التلقائية: عند تغيير مزوّد التضمينات أو النموذج أو إعداد تقسيم المقاطع، يُعاد بناء الفهرس بالكامل تلقائيًا.
- إعادة الفهرسة عند الطلب:
openclaw memory index --force
متى تستخدمه
المحرك المدمج هو الخيار المناسب لمعظم المستخدمين:
- يعمل مباشرةً من دون اعتماديات إضافية.
- يتعامل جيدًا مع البحث بالكلمات المفتاحية والبحث المتجهي.
- يدعم جميع مزوّدي التضمينات.
- يجمع البحث الهجين بين أفضل ما في نهجي الاسترجاع.
فكّر في التبديل إلى QMD إذا كنت تحتاج إلى إعادة ترتيب النتائج أو توسيع الاستعلامات أو تريد فهرسة أدلة خارج مساحة العمل.
فكّر في Honcho إذا كنت تريد ذاكرة عابرة للجلسات مع نمذجة تلقائية للمستخدم.
استكشاف الأخطاء وإصلاحها
هل بحث الذاكرة معطّل؟ تحقّق من openclaw memory status. إذا لم يُكتشف أي مزوّد،
فعيّن واحدًا صراحةً أو أضف مفتاح API.
ألم يُكتشف المزوّد المحلي؟ تأكّد من وجود المسار المحلي وشغّل:
openclaw memory status --deep --agent mainopenclaw memory index --force --agent mainتستخدم أوامر CLI المستقلة وGateway معرّف المزوّد نفسه local.
عيّن memorySearch.provider: "local" عندما تريد تضمينات محلية.
هل النتائج قديمة؟ شغّل openclaw memory index --force لإعادة البناء. قد تفوّت
المراقبة تغييرات في حالات طرفية نادرة.
ألا يتم تحميل sqlite-vec؟ يعود OpenClaw تلقائيًا إلى تشابه جيب التمام داخل العملية.
يعرض openclaw memory status --deep مخزن المتجهات المحلي بشكل منفصل عن مزوّد
التضمينات، لذا تشير Vector store: unavailable إلى تحميل sqlite-vec بينما تشير
Embeddings: unavailable إلى جاهزية المزوّد/المصادقة أو النموذج. تحقّق من السجلات
لمعرفة خطأ التحميل المحدد.
الإعدادات
لإعداد مزوّد التضمينات، وضبط البحث الهجين (الأوزان، MMR، التضاؤل الزمني)، والفهرسة على دفعات، والذاكرة متعددة الوسائط، وsqlite-vec، والمسارات الإضافية، وجميع مفاتيح الإعدادات الأخرى، راجع مرجع إعدادات الذاكرة.
