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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Dreaming هو نظام دمج الذاكرة في الخلفية ضمن memory-core. يساعد OpenClaw على نقل الإشارات القصيرة الأمد القوية إلى ذاكرة دائمة مع إبقاء العملية قابلة للشرح والمراجعة.
Dreaming اختياري التفعيل ومعطّل افتراضيًا.

ما الذي يكتبه Dreaming

يحتفظ Dreaming بنوعين من المخرجات:
  • حالة الآلة في memory/.dreams/ (مخزن الاستدعاء، إشارات المراحل، نقاط تحقق الإدخال، الأقفال).
  • مخرجات قابلة للقراءة البشرية في DREAMS.md (أو dreams.md الموجود) وملفات تقارير مراحل اختيارية ضمن memory/dreaming/<phase>/YYYY-MM-DD.md.
لا تزال الترقية طويلة الأمد تكتب فقط إلى MEMORY.md.

نموذج المراحل

يستخدم Dreaming ثلاث مراحل تعاونية:
المرحلةالغرضالكتابة الدائمة
Lightفرز وتجهيز المواد القصيرة الأمد الحديثةلا
Deepتسجيل المرشحين الدائمين وترقيتهمنعم (MEMORY.md)
REMالتأمل في السمات والأفكار المتكررةلا
هذه المراحل تفاصيل تنفيذ داخلية، وليست “أوضاعًا” منفصلة يضبطها المستخدم.
تستوعب مرحلة Light إشارات الذاكرة اليومية الحديثة وآثار الاستدعاء، وتزيل التكرار منها، وتجهّز أسطرًا مرشحة.
  • تقرأ من حالة الاستدعاء القصيرة الأمد، وملفات الذاكرة اليومية الحديثة، ونصوص الجلسات المنقحة عند توفرها.
  • تكتب كتلة مُدارة ## Light Sleep عندما يتضمن التخزين مخرجات مضمنة.
  • تسجل إشارات تعزيز للترتيب العميق لاحقًا.
  • لا تكتب أبدًا إلى MEMORY.md.
تقرر مرحلة Deep ما يصبح ذاكرة طويلة الأمد.
  • ترتب المرشحين باستخدام تسجيل موزون وبوابات عتبات.
  • تتطلب اجتياز minScore وminRecallCount وminUniqueQueries.
  • تعيد تحميل المقاطع من الملفات اليومية الحية قبل الكتابة، بحيث يتم تخطي المقاطع القديمة أو المحذوفة.
  • تلحق الإدخالات المرقّاة بـ MEMORY.md.
  • تكتب ملخص ## Deep Sleep في DREAMS.md وتكتب اختياريًا memory/dreaming/deep/YYYY-MM-DD.md.
تستخرج مرحلة REM الأنماط والإشارات التأملية.
  • تبني ملخصات السمات والتأملات من الآثار القصيرة الأمد الحديثة.
  • تكتب كتلة مُدارة ## REM Sleep عندما يتضمن التخزين مخرجات مضمنة.
  • تسجل إشارات تعزيز REM التي يستخدمها الترتيب العميق.
  • لا تكتب أبدًا إلى MEMORY.md.

إدخال نصوص الجلسات

يمكن لـ Dreaming إدخال نصوص الجلسات المنقحة إلى مجموعة بيانات Dreaming. عند توفر النصوص، تُغذّى في مرحلة Light إلى جانب إشارات الذاكرة اليومية وآثار الاستدعاء. تُنقّح المحتويات الشخصية والحساسة قبل الإدخال.

مفكرة الأحلام

يحتفظ Dreaming أيضًا بـ مفكرة أحلام سردية في DREAMS.md. بعد أن تتوفر لكل مرحلة مادة كافية، يشغّل memory-core دورة وكيل فرعي في الخلفية بأفضل جهد ويلحق إدخال مفكرة قصيرًا. يستخدم نموذج وقت التشغيل الافتراضي ما لم يتم ضبط dreaming.model. إذا كان النموذج المضبوط غير متاح، تعيد مفكرة الأحلام المحاولة مرة واحدة باستخدام النموذج الافتراضي للجلسة.
هذه المفكرة مخصصة للقراءة البشرية في واجهة الأحلام، وليست مصدرًا للترقية. تُستبعد آثار المفكرة/التقارير التي أنشأها Dreaming من الترقية القصيرة الأمد. وحدها مقاطع الذاكرة المؤسَّسة مؤهلة للترقية إلى MEMORY.md.
يوجد أيضًا مسار تعبئة خلفية تاريخي مؤسَّس لأعمال المراجعة والاسترداد:
  • يعاين memory rem-harness --path ... --grounded مخرجات مفكرة مؤسَّسة من ملاحظات YYYY-MM-DD.md التاريخية.
  • يكتب memory rem-backfill --path ... إدخالات مفكرة مؤسَّسة وقابلة للعكس في DREAMS.md.
  • يجهّز memory rem-backfill --path ... --stage-short-term مرشحين دائمين مؤسَّسين في مخزن الأدلة القصيرة الأمد نفسه الذي تستخدمه مرحلة Deep العادية بالفعل.
  • يزيل memory rem-backfill --rollback و--rollback-short-term آثار التعبئة الخلفية المجهزة تلك من دون لمس إدخالات المفكرة العادية أو الاستدعاء القصير الأمد الحي.
تعرض واجهة التحكم تدفق التعبئة الخلفية/إعادة الضبط نفسه للمفكرة حتى تتمكن من فحص النتائج في مشهد الأحلام قبل أن تقرر ما إذا كان المرشحون المؤسَّسون يستحقون الترقية. يعرض المشهد أيضًا مسارًا مؤسَّسًا مميزًا حتى ترى أي إدخالات قصيرة الأمد مجهزة جاءت من إعادة تشغيل تاريخية، وأي عناصر مرقّاة كانت بقيادة مؤسَّسة، وتمسح فقط الإدخالات المؤسَّسة فقط المجهزة من دون لمس حالة الذاكرة القصيرة الأمد الحية العادية.

إشارات الترتيب العميق

يستخدم الترتيب العميق ست إشارات أساسية موزونة بالإضافة إلى تعزيز المراحل:
الإشارةالوزنالوصف
التكرار0.24عدد الإشارات القصيرة الأمد التي جمعها الإدخال
الملاءمة0.30متوسط جودة الاسترجاع للإدخال
تنوع الاستعلامات0.15سياقات الاستعلام/اليوم المميزة التي أظهرته
الحداثة0.15درجة حداثة متناقصة زمنيًا
الدمج0.10قوة التكرار على عدة أيام
الثراء المفاهيمي0.06كثافة وسوم المفاهيم من المقطع/المسار
تضيف إصابات مرحلتي Light وREM تعزيزًا صغيرًا متناقصًا بالحداثة من memory/.dreams/phase-signals.json.

الجدولة

عند التفعيل، يدير memory-core تلقائيًا مهمة cron واحدة لمسح Dreaming كامل. يشغّل كل مسح المراحل بالترتيب: Light → REM → Deep. يتضمن المسح مساحة عمل وقت التشغيل الأساسية وأي مساحات عمل وكلاء مضبوطة، مع إزالة التكرار حسب المسار، لذلك لا يستبعد تفريع مساحات عمل الوكلاء الفرعيين ملف DREAMS.md وحالة الذاكرة للوكيل الرئيسي. سلوك الوتيرة الافتراضي:
الإعدادالافتراضي
dreaming.frequency0 3 * * *
dreaming.modelالنموذج الافتراضي

البدء السريع

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

أمر الشرطة المائلة

/dreaming status
/dreaming on
/dreaming off
/dreaming help

سير عمل CLI

openclaw memory promote
openclaw memory promote --apply
openclaw memory promote --limit 5
openclaw memory status --deep
يستخدم memory promote اليدوي عتبات مرحلة Deep افتراضيًا ما لم تُستبدل بعلامات CLI.

الإعدادات الافتراضية الأساسية

توجد جميع الإعدادات تحت plugins.entries.memory-core.config.dreaming.
enabled
boolean
افتراضي:"false"
فعّل أو عطّل مسح Dreaming.
frequency
string
افتراضي:"0 3 * * *"
وتيرة Cron لمسح Dreaming الكامل.
model
string
استبدال اختياري لنموذج الوكيل الفرعي لمفكرة الأحلام. استخدم قيمة provider/model معيارية عند تعيين قائمة سماح allowedModels للوكيل الفرعي أيضًا.
يتطلب dreaming.model ضبط plugins.entries.memory-core.subagent.allowModelOverride: true. لتقييده، اضبط أيضًا plugins.entries.memory-core.subagent.allowedModels. تبقى إخفاقات الثقة أو قائمة السماح مرئية بدل الرجوع بصمت؛ ولا تغطي إعادة المحاولة إلا أخطاء عدم توفر النموذج.
سياسة المراحل، والعتبات، وسلوك التخزين تفاصيل تنفيذ داخلية (وليست إعدادات موجّهة للمستخدم). راجع مرجع إعدادات الذاكرة للاطلاع على قائمة المفاتيح الكاملة.

واجهة الأحلام

عند التفعيل، يعرض تبويب الأحلام في Gateway ما يلي:
  • حالة تفعيل Dreaming الحالية
  • الحالة على مستوى المراحل ووجود المسح المُدار
  • أعداد القصير الأمد، والمؤسَّس، والإشارات، والمرقّى اليوم
  • توقيت التشغيل المجدول التالي
  • مسار مشهد مؤسَّس مميز لإدخالات إعادة التشغيل التاريخية المجهزة
  • قارئ مفكرة أحلام قابل للتوسيع ومدعوم بـ doctor.memory.dreamDiary

Dreaming لا يعمل أبدًا: تعرض الحالة أنه محظور

إذا أبلغ openclaw memory status عن Dreaming status: blocked، فإن Cron المُدار موجود لكن Heartbeat للوكيل الافتراضي لا يعمل. تحقق من أن Heartbeat مفعّل للوكيل الافتراضي وأن هدفه ليس none، ثم شغّل openclaw memory status --deep مجددًا بعد فترة Heartbeat التالية.

ذو صلة