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

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

# كيف يعمل

لدى وكيلك ثلاثة ملفات مرتبطة بالذاكرة:

• MEMORY.md — الذاكرة طويلة الأمد. حقائق وتفضيلات وقرارات دائمة. تُحمّل في بداية كل جلسة DM.
• memory/YYYY-MM-DD.md — ملاحظات يومية. سياق وملاحظات جارية. تُحمّل ملاحظات اليوم والأمس تلقائيًا.
• DREAMS.md (اختياري) — مذكرات Dream Diary وملخصات جولات Dreaming للمراجعة البشرية، بما في ذلك إدخالات الاستكمال التاريخي المؤسّسة على أدلة.

توجد هذه الملفات في مساحة عمل الوكيل (الافتراضي ~/.openclaw/workspace).

# الالتزامات المستنتجة

ليست كل المتابعات المستقبلية حقائق دائمة. إذا ذكرت مقابلة غدًا، فقد تكون الذاكرة المفيدة هي "تابع بعد المقابلة"، لا "خزّن هذا إلى الأبد في MEMORY.md."

الالتزامات هي ذكريات متابعة اختيارية وقصيرة الأجل لهذه الحالة. يستنتجها OpenClaw في تمريرة خلفية مخفية، ويقيّد نطاقها بالوكيل والقناة نفسيهما، ويوصل المتابعات المستحقة عبر Heartbeat. ما تزال التذكيرات الصريحة تستخدم المهام المجدولة.

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

لدى الوكيل أداتان للعمل مع الذاكرة:

• 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.

# بحث الذاكرة

عند تكوين مزوّد تضمينات، يستخدم memory_search بحثًا هجينًا — يجمع بين التشابه المتجهي (المعنى الدلالي) ومطابقة الكلمات المفتاحية (مصطلحات دقيقة مثل المعرّفات ورموز الشيفرة). يعمل هذا مباشرة بمجرد امتلاك مفتاح API لأي مزوّد مدعوم.

للحصول على تفاصيل حول كيفية عمل البحث وخيارات الضبط وإعداد المزوّد، انظر بحث الذاكرة.

# خلفيات الذاكرة

# طبقة wiki المعرفة

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

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

لإبقاء دورة الصيانة هذه على نموذج محلي، عيّن تجاوزًا دقيقًا لنموذج تفريغ الذاكرة:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

ينطبق التجاوز فقط على دورة تفريغ الذاكرة ولا يرث سلسلة الرجوع الاحتياطية للجلسة النشطة.

# Dreaming

Dreaming هو تمريرة دمج خلفية اختيارية للذاكرة. يجمع الإشارات قصيرة الأجل، ويقيّم المرشحين، ولا يرقّي إلى الذاكرة طويلة الأمد (MEMORY.md) إلا العناصر المؤهلة.

صُمم للحفاظ على ذاكرة طويلة الأمد عالية الإشارة:

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

للاطلاع على سلوك المراحل، وإشارات التقييم، وتفاصيل Dream Diary، انظر 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          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

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

• محرك الذاكرة المضمّن: خلفية SQLite الافتراضية.
• محرك ذاكرة QMD: مرافق محلي أولًا متقدم.
• ذاكرة Honcho: ذاكرة عبر الجلسات أصلية للذكاء الاصطناعي.
• Memory LanceDB: Plugin مدعوم بـ LanceDB مع تضمينات متوافقة مع OpenAI.
• Memory Wiki: مخزن معرفة مجمّع وأدوات أصلية للـ wiki.
• بحث الذاكرة: مسار البحث والمزوّدون والضبط.
• Dreaming: ترقية خلفية من الاستدعاء قصير الأجل إلى الذاكرة طويلة الأمد.
• مرجع تكوين الذاكرة: جميع مقابض التكوين.
• Compaction: كيف يتفاعل Compaction مع الذاكرة.

# ذات صلة

• Active Memory
• بحث الذاكرة
• محرك الذاكرة المضمّن
• ذاكرة Honcho
• Memory LanceDB
• الالتزامات