openclaw memory

إدارة فهرسة الذاكرة الدلالية والبحث فيها. يوفرها Plugin المضمّن memory-core. يكون الأمر متاحًا عندما يحدد plugins.slots.memory القيمة memory-core (الافتراضي)؛ وتعرض Plugins الذاكرة الأخرى مساحات أسماء CLI الخاصة بها.

ذات صلة:

• مفهوم الذاكرة: الذاكرة
• ويكي الذاكرة: ويكي الذاكرة
• CLI الويكي: wiki
• Plugins: Plugins

أمثلة

openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

الخيارات

memory status وmemory index:

• --agent <id>: حصر النطاق في وكيل واحد. من دونه، تعمل هذه الأوامر لكل وكيل مُكوَّن؛ وإذا لم تكن قائمة الوكلاء مُكوَّنة، فإنها تعود إلى الوكيل الافتراضي.
• --verbose: إخراج سجلات تفصيلية أثناء الفحوصات والفهرسة.

memory status:

• --deep: فحص جاهزية مخزن المتجهات المحلي، وجاهزية موفر التضمينات، وجاهزية البحث الدلالي بالمتجهات. يبقى memory status العادي سريعًا ولا يشغّل عمل تضمين مباشر أو اكتشاف موفرين؛ وتعني حالة مخزن المتجهات أو المتجه الدلالي غير المعروفة أنها لم تُفحص في ذلك الأمر. يتجاوز QMD lexical searchMode: "search" فحوصات المتجهات الدلالية وصيانة التضمينات حتى مع --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). يجب أن يكون مستدعو القناة مالكين لتغيير الإعداد؛ ويحتاج عملاء Gateway إلى operator.admin. تظل حالة القراءة فقط والمساعدة متاحتين لمرسلي الأوامر المخولين.
• يعمل 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 البعيدة لـ Active Memory الفعالة مُكوَّنة كـ SecretRefs، فإن الأمر يحل تلك القيم من لقطة Gateway النشطة. إذا كان Gateway غير متاح، يفشل الأمر بسرعة.
• ملاحظة انحراف إصدار Gateway: يتطلب مسار الأمر هذا Gateway يدعم secrets.resolve؛ وتعيد Gateways الأقدم خطأ طريقة غير معروفة.
• اضبط وتيرة المسح المجدول باستخدام dreaming.frequency. بخلاف ذلك، تكون سياسة الترويج العميق داخلية باستثناء dreaming.phases.deep.maxPromotedSnippetTokens، الذي يحد طول المقتطف المُرقّى مع إبقاء الأصل ظاهرًا. استخدم علامات 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 لمراجعة واجهة المستخدم.
• يقوم memory rem-backfill --path <file-or-dir> --stage-short-term أيضًا بزرع مرشحين دائمين مؤسَّسين في مخزن الترويج قصير الأمد الحي حتى تتمكن مرحلة deep العادية من ترتيبهم.
• يزيل memory rem-backfill --rollback إدخالات اليوميات المؤسَّسة المكتوبة سابقًا، ويزيل memory rem-backfill --rollback-short-term المرشحين المؤسَّسين قصيري الأمد الذين جرى تجهيزهم سابقًا.
• راجع Dreaming للاطلاع على أوصاف المراحل الكاملة ومرجع التكوين.

ذات صلة

• مرجع CLI
• نظرة عامة على الذاكرة