الانتقال إلى المحتوى الرئيسي

​
نظرة عامة على الذاكرة

يتذكر OpenClaw الأشياء من خلال كتابة ملفات Markdown عادية في مساحة عمل الوكيل الخاصة بك. لا “يتذكر” النموذج إلا ما يتم حفظه على القرص — لا توجد حالة مخفية.

​
كيف يعمل

يحتوي وكيلك على ثلاثة ملفات مرتبطة بالذاكرة:
  • MEMORY.md — الذاكرة طويلة الأمد. الحقائق الدائمة، والتفضيلات، والقرارات. يتم تحميلها عند بداية كل جلسة رسالة مباشرة.
  • memory/YYYY-MM-DD.md — الملاحظات اليومية. سياق جارٍ وملاحظات. يتم تحميل ملاحظات اليوم والأمس تلقائيًا.
  • DREAMS.md (اختياري) — يوميات الأحلام وملخصات اجتياح Dreaming لمراجعة البشر، بما في ذلك إدخالات التعبئة التاريخية المرتكزة.
توجد هذه الملفات في مساحة عمل الوكيل (الافتراضي ~/.openclaw/workspace).
إذا كنت تريد أن يتذكر وكيلك شيئًا ما، فما عليك إلا أن تطلب منه ذلك: “تذكر أنني أفضل TypeScript.” وسيكتبه في الملف المناسب.

​
أدوات الذاكرة

يحتوي الوكيل على أداتين للعمل مع الذاكرة:
  • memory_search — يعثر على الملاحظات ذات الصلة باستخدام البحث الدلالي، حتى عندما تختلف الصياغة عن الأصل.
  • memory_get — يقرأ ملف ذاكرة محددًا أو نطاقًا معينًا من الأسطر.
يتم توفير كلتا الأداتين بواسطة Plugin الذاكرة النشط (الافتراضي: memory-core).

​
Plugin المصاحب Memory Wiki

إذا كنت تريد أن تتصرف الذاكرة الدائمة أشبه بقاعدة معرفة مُدارة بدلاً من أن تكون مجرد ملاحظات خام، فاستخدم Plugin المضمن memory-wiki. يقوم memory-wiki بتجميع المعرفة الدائمة في مخزن wiki مع:
  • بنية صفحات حتمية
  • ادعاءات وأدلة منظمة
  • تتبع التناقضات والحداثة
  • لوحات معلومات مولدة
  • ملخصات مجمعة لمستهلكي الوكيل/وقت التشغيل
  • أدوات أصلية لـ wiki مثل wiki_search وwiki_get وwiki_apply وwiki_lint
وهو لا يستبدل Plugin الذاكرة النشط. يظل Plugin الذاكرة النشط مسؤولًا عن الاسترجاع، والترقية، وDreaming. ويضيف memory-wiki طبقة معرفة غنية بالمصدر إلى جانبه. راجع Memory Wiki.

​
البحث في الذاكرة

عند تهيئة موفر embeddings، يستخدم memory_search البحث الهجين — أي الجمع بين التشابه المتجهي (المعنى الدلالي) ومطابقة الكلمات المفتاحية (مصطلحات دقيقة مثل المعرّفات ورموز الشيفرة). يعمل هذا مباشرة بمجرد امتلاكك مفتاح API لأي موفر مدعوم.
يكتشف OpenClaw موفر embeddings لديك تلقائيًا من مفاتيح API المتاحة. إذا كان لديك مفتاح OpenAI أو Gemini أو Voyage أو Mistral مهيأ، فسيتم تفعيل البحث في الذاكرة تلقائيًا.
للتفاصيل حول كيفية عمل البحث، وخيارات الضبط، وإعداد الموفر، راجع Memory Search.

​
الواجهات الخلفية للذاكرة

مدمج (افتراضي)

قائم على SQLite. يعمل مباشرة مع البحث بالكلمات المفتاحية، والتشابه المتجهي، والبحث الهجين. لا توجد تبعيات إضافية.

QMD

خدمة جانبية محلية أولًا مع إعادة ترتيب النتائج، وتوسيع الاستعلام، وإمكانية فهرسة الأدلة خارج مساحة العمل.

Honcho

ذاكرة عابرة للجلسات أصلية للذكاء الاصطناعي مع نمذجة المستخدم، والبحث الدلالي، والوعي بتعدد الوكلاء. تثبيت عبر Plugin.

​
طبقة wiki المعرفية

Memory Wiki

يجمع الذاكرة الدائمة في مخزن wiki غني بالمصدر مع ادعاءات، ولوحات معلومات، ووضع الجسر، وتدفقات عمل متوافقة مع Obsidian.

​
التفريغ التلقائي للذاكرة

قبل أن يلخص Compaction محادثتك، يقوم OpenClaw بتشغيل دور صامت يذكّر الوكيل بحفظ السياق المهم في ملفات الذاكرة. هذا مفعّل افتراضيًا — ولا تحتاج إلى إعداد أي شيء.
يمنع تفريغ الذاكرة فقدان السياق أثناء Compaction. إذا كانت لدى وكيلك حقائق مهمة في المحادثة لم تُكتب بعد إلى ملف، فسيتم حفظها تلقائيًا قبل حدوث التلخيص.

​
Dreaming

Dreaming هو تمرير اختياري في الخلفية لتجميع الذاكرة. يجمع الإشارات قصيرة الأمد، ويقيّم المرشحين، ويرقّي فقط العناصر المؤهلة إلى الذاكرة طويلة الأمد (MEMORY.md). وقد صُمم للحفاظ على ارتفاع قيمة الإشارة في الذاكرة طويلة الأمد:
  • اشتراك اختياري: معطّل افتراضيًا.
  • مجدول: عند تفعيله، يدير memory-core تلقائيًا مهمة Cron متكررة واحدة لاجتياح Dreaming كامل.
  • مضبوط بعتبات: يجب أن تجتاز الترقيات بوابات الدرجة، وتكرار الاسترجاع، وتنوع الاستعلامات.
  • قابل للمراجعة: تُكتب ملخصات المراحل وإدخالات اليوميات إلى DREAMS.md لمراجعة البشر.
للاطلاع على سلوك المراحل، وإشارات التقييم، وتفاصيل يوميات الأحلام، راجع Dreaming.

​
التعبئة المرتكزة والترقية المباشرة

يحتوي نظام Dreaming الآن على مسارين متقاربين للمراجعة:
  • يعمل Dreaming المباشر من مخزن Dreaming قصير الأمد تحت memory/.dreams/، وهو ما تستخدمه المرحلة العميقة العادية عند تقرير ما يمكن أن يترقى إلى MEMORY.md.
  • تقرأ التعبئة المرتكزة الملاحظات التاريخية memory/YYYY-MM-DD.md على شكل ملفات أيام مستقلة، وتكتب مخرجات مراجعة منظمة إلى DREAMS.md.
تكون التعبئة المرتكزة مفيدة عندما تريد إعادة تشغيل الملاحظات الأقدم وفحص ما يعتقده النظام بأنه دائم دون تعديل MEMORY.md يدويًا. عندما تستخدم: 
openclaw memory rem-backfill --path ./memory --stage-short-term
فإن المرشحين الدائمين المرتكزين لا تتم ترقيتهم مباشرة. بل يتم تجهيزهم في مخزن Dreaming قصير الأمد نفسه الذي تستخدمه المرحلة العميقة العادية بالفعل. وهذا يعني:
  • يظل DREAMS.md سطح المراجعة المخصص للبشر.
  • يظل المخزن قصير الأمد سطح الترتيب المخصص للآلة.
  • لا يزال MEMORY.md يُكتب فقط بواسطة الترقية العميقة.
إذا قررت أن إعادة التشغيل لم تكن مفيدة، فيمكنك إزالة العناصر المرحلية من دون المساس بإدخالات اليوميات العادية أو حالة الاسترجاع المعتادة: 
openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

​
CLI

openclaw memory status          # تحقق من حالة الفهرس والموفر
openclaw memory search "query"  # ابحث من سطر الأوامر
openclaw memory index --force   # أعد بناء الفهرس

​
قراءة إضافية

  • Builtin Memory Engine — الواجهة الخلفية الافتراضية المعتمدة على SQLite
  • QMD Memory Engine — خدمة جانبية متقدمة محلية أولًا
  • Honcho Memory — ذاكرة أصلية للذكاء الاصطناعي عابرة للجلسات
  • Memory Wiki — مخزن معرفة مجمّع وأدوات أصلية لـ wiki
  • Memory Search — مسار البحث، والموفرون، والضبط
  • Dreaming — الترقية في الخلفية من الاسترجاع قصير الأمد إلى الذاكرة طويلة الأمد
  • مرجع إعدادات الذاكرة — جميع مفاتيح الإعداد
  • Compaction — كيف يتفاعل Compaction مع الذاكرة