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

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.

​
openclaw memory

إدارة فهرسة الذاكرة الدلالية والبحث فيها. يُوفَّر بواسطة Plugin الذاكرة النشطة (الافتراضي: memory-core؛ اضبط plugins.slots.memory = "none" للتعطيل). ذات صلة:

​
أمثلة

openclaw memory status
openclaw memory status --deep
openclaw memory status --fix
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory promote --limit 10 --min-score 0.75
openclaw memory promote --apply
openclaw memory promote --json --min-recall-count 0 --min-unique-queries 0
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
openclaw memory rem-harness
openclaw memory rem-harness --json
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose

​
الخيارات

memory status وmemory index:
  • --agent <id>: حصر النطاق في وكيل واحد. بدونه، تعمل هذه الأوامر لكل وكيل مهيأ؛ وإذا لم تكن هناك قائمة وكلاء مهيأة، فستعود إلى الوكيل الافتراضي.
  • --verbose: إصدار سجلات مفصلة أثناء الفحوصات والفهرسة.
memory status:
  • --deep: فحص جاهزية مخزن المتجهات المحلي، وجاهزية مزود التضمينات، وجاهزية بحث المتجهات الدلالي. يبقى memory status العادي سريعًا ولا يشغل عمل التضمين الحي أو اكتشاف المزود؛ وتعني حالة مخزن المتجهات أو المتجهات الدلالية غير المعروفة أنه لم يتم فحصها في ذلك الأمر. يتخطى searchMode: "search" المعجمي في QMD فحوصات المتجهات الدلالية وصيانة التضمينات حتى مع --deep.
  • --index: تشغيل إعادة فهرسة إذا كان المخزن متسخًا (يتضمن --deep).
  • --fix: إصلاح أقفال الاستدعاء القديمة وتطبيع بيانات الترويج الوصفية.
  • --json: طباعة مخرجات JSON.
إذا عرض memory status الحالة Dreaming status: blocked، فهذا يعني أن Cron المدار لـ Dreaming ممكّن لكن Heartbeat الذي يشغله لا يعمل للوكيل الافتراضي. راجع Dreaming لا يعمل أبدًا لمعرفة السببين الشائعين. memory index:
  • --force: فرض إعادة فهرسة كاملة.
memory search:
  • إدخال الاستعلام: مرر إما [query] موضعيًا أو --query <text>.
  • إذا تم توفير كليهما، تكون الغلبة لـ--query.
  • إذا لم يتم توفير أي منهما، يخرج الأمر بخطأ.
  • --agent <id>: حصر النطاق في وكيل واحد (الافتراضي: الوكيل الافتراضي).
  • --max-results <n>: تحديد عدد النتائج المُعادة.
  • --min-score <n>: تصفية التطابقات ذات الدرجات المنخفضة.
  • --json: طباعة نتائج JSON.
memory promote: معاينة ترقيات الذاكرة قصيرة المدى وتطبيقها. 
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply — كتابة الترقيات إلى MEMORY.md (الافتراضي: المعاينة فقط).
  • --limit <n> — تحديد عدد المرشحين المعروضين بحد أقصى.
  • --include-promoted — تضمين الإدخالات التي تمت ترقيتها بالفعل في الدورات السابقة.
الخيارات الكاملة:
  • يرتب المرشحين قصيري المدى من memory/YYYY-MM-DD.md باستخدام إشارات ترقية موزونة (frequency، relevance، query diversity، recency، consolidation، conceptual richness).
  • يستخدم إشارات قصيرة المدى من استدعاءات الذاكرة وتمريرات الاستيعاب اليومية معًا، بالإضافة إلى إشارات تعزيز مرحلتي light/REM.
  • عند تمكين Dreaming، يدير memory-core تلقائيًا مهمة Cron واحدة تشغل مسحًا كاملًا (light -> REM -> deep) في الخلفية (لا يلزم تنفيذ openclaw cron add يدويًا).
  • --agent <id>: حصر النطاق في وكيل واحد (الافتراضي: الوكيل الافتراضي).
  • --limit <n>: الحد الأقصى للمرشحين المراد إرجاعهم/تطبيقهم.
  • --min-score <n>: الحد الأدنى لدرجة الترقية الموزونة.
  • --min-recall-count <n>: الحد الأدنى لعدد مرات الاستدعاء المطلوب للمرشح.
  • --min-unique-queries <n>: الحد الأدنى لعدد الاستعلامات المميزة المطلوب للمرشح.
  • --apply: إلحاق المرشحين المحددين في MEMORY.md ووضع علامة عليهم بأنهم رُقّوا.
  • --include-promoted: تضمين المرشحين الذين تمت ترقيتهم بالفعل في المخرجات.
  • --json: طباعة مخرجات JSON.
memory promote-explain: شرح مرشح ترقية محدد وتفصيل درجته. 
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: مفتاح المرشح، أو جزء من المسار، أو جزء من المقتطف للبحث عنه.
  • --agent <id>: حصر النطاق في وكيل واحد (الافتراضي: الوكيل الافتراضي).
  • --include-promoted: تضمين المرشحين الذين تمت ترقيتهم بالفعل.
  • --json: طباعة مخرجات JSON.
memory rem-harness: معاينة تأملات REM، والحقائق المرشحة، ومخرجات الترقية العميقة دون كتابة أي شيء. 
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
  • --agent <id>: حصر النطاق في وكيل واحد (الافتراضي: الوكيل الافتراضي).
  • --include-promoted: تضمين المرشحين العميقين الذين تمت ترقيتهم بالفعل.
  • --json: طباعة مخرجات JSON.

​
Dreaming

Dreaming هو نظام دمج الذاكرة في الخلفية، ويتضمن ثلاث مراحل تعاونية: light (فرز/تهيئة المواد قصيرة المدى)، وdeep (ترقية الحقائق الدائمة إلى MEMORY.md)، وREM (التأمل وإبراز الموضوعات).
  • فعّله باستخدام plugins.entries.memory-core.config.dreaming.enabled: true.
  • بدّله من الدردشة باستخدام /dreaming on|off (أو افحصه باستخدام /dreaming status).
  • يعمل Dreaming وفق جدول مسح مُدار واحد (dreaming.frequency) وينفذ المراحل بالترتيب: light، REM، deep.
  • تكتب مرحلة deep فقط الذاكرة الدائمة إلى MEMORY.md.
  • تُكتب مخرجات المراحل المقروءة للبشر وإدخالات اليوميات إلى DREAMS.md (أو dreams.md الموجود)، مع تقارير اختيارية لكل مرحلة في memory/dreaming/<phase>/YYYY-MM-DD.md.
  • يستخدم الترتيب إشارات موزونة: تكرار الاستدعاء، وصلة الاسترجاع، وتنوع الاستعلامات، والحداثة الزمنية، والدمج عبر الأيام، وثراء المفاهيم المشتق.
  • تعيد الترقية قراءة الملاحظة اليومية الحية قبل الكتابة إلى MEMORY.md، لذلك لا تتم ترقية المقتطفات قصيرة المدى المعدلة أو المحذوفة من لقطات مخزن الاستدعاء القديمة.
  • تشترك عمليات memory promote المجدولة واليدوية في افتراضيات مرحلة deep نفسها ما لم تمرر تجاوزات عتبات عبر CLI.
  • تتوزع عمليات التشغيل التلقائية عبر مساحات عمل الذاكرة المهيأة.
الجدولة الافتراضية:
  • إيقاع المسح: dreaming.frequency = 0 3 * * *
  • عتبات deep: minScore=0.8، minRecallCount=3، minUniqueQueries=3، recencyHalfLifeDays=14، maxAgeDays=30
مثال: 
{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}
ملاحظات:
  • يطبع memory index --verbose تفاصيل كل مرحلة (المزود، والنموذج، والمصادر، ونشاط الدُفعات).
  • يتضمن memory status أي مسارات إضافية مهيأة عبر memorySearch.extraPaths.
  • إذا كانت حقول مفاتيح API البعيدة للذاكرة النشطة فعليًا مهيأة كـSecretRefs، يحل الأمر هذه القيم من لقطة Gateway النشطة. إذا لم يكن Gateway متاحًا، يفشل الأمر بسرعة.
  • ملاحظة انحراف إصدار Gateway: يتطلب مسار هذا الأمر Gateway يدعم secrets.resolve؛ وتعيد بوابات Gateway الأقدم خطأ طريقة غير معروفة.
  • اضبط إيقاع المسح المجدول باستخدام dreaming.frequency. تكون سياسة ترقية deep داخلية خلاف ذلك؛ استخدم أعلام CLI على memory promote عندما تحتاج إلى تجاوزات يدوية لمرة واحدة.
  • يعاين memory rem-harness --path <file-or-dir> --grounded الأقسام المؤصلة What Happened وReflections وPossible Lasting Updates من الملاحظات اليومية التاريخية دون كتابة أي شيء.
  • يكتب memory rem-backfill --path <file-or-dir> إدخالات يوميات مؤصلة قابلة للعكس في DREAMS.md لمراجعة UI.
  • يقوم memory rem-backfill --path <file-or-dir> --stage-short-term أيضًا بزرع مرشحين دائمين مؤصلين في مخزن الترقية قصير المدى الحي كي تتمكن مرحلة deep العادية من ترتيبهم.
  • يزيل memory rem-backfill --rollback إدخالات اليوميات المؤصلة المكتوبة سابقًا، ويزيل memory rem-backfill --rollback-short-term المرشحين المؤصلين قصيري المدى الذين تمت تهيئتهم سابقًا.
  • راجع Dreaming للاطلاع على أوصاف المراحل الكاملة ومرجع التهيئة.

​
ذات صلة