openclaw memory

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

ذو صلة: مفهوم الذاكرة، وDreaming، ومرجع إعدادات الذاكرة، وويكي الذاكرة، والويكي، وPlugins.

memory status

openclaw memory status [--agent <id>] [--deep] [--index] [--fix] [--json] [--verbose]

من دون --agent، يُشغّل الأمر لكل وكيل في agents.list؛ وإذا لم تكن قائمة الوكلاء مُعدّة، فإنه يعود إلى الوكيل الافتراضي.

إذا ظل سطر Dreaming على off حتى مع dreaming.enabled: true، أو بدا أن عمليات المسح المجدولة لا تعمل مطلقًا، فإن Cron المُدار لـ Dreaming يعتمد على تشغيل Heartbeat للوكيل الافتراضي لبدء المطابقة. راجع Dreaming للاطلاع على تفاصيل الجدولة.

تسرد الحالة أيضًا أي مسارات بحث إضافية من agents.defaults.memorySearch.extraPaths.

memory index

openclaw memory index [--agent <id>] [--force] [--verbose]

نطاق التنفيذ لكل وكيل هو نفسه في status. يشغّل --force إعادة فهرسة كاملة بدلًا من إعادة فهرسة تزايدية. يطبع --verbose تفاصيل الموفّر والنموذج والمصادر والمسارات الإضافية لكل وكيل قبل عرض تقدم الفهرسة.

memory search

openclaw memory search [query] [--query <text>] [--agent <id>] [--max-results <n>] [--min-score <n>] [--json]

• الاستعلام: [query] كوسيط موضعي أو --query <text>. إذا حُددا معًا، تكون الأولوية لـ --query. وإذا لم يُحدد أي منهما، يُرجع الأمر خطأ.
• --agent <id>: يستخدم الوكيل الافتراضي افتراضيًا (وليس قائمة الوكلاء كاملة).
• --max-results <n>: يحدد حدًا أقصى لعدد النتائج (عدد صحيح موجب).
• --min-score <n>: يستبعد التطابقات التي تقل عن هذه الدرجة.

memory promote

يرتّب المرشحين قصيري الأمد من memory/YYYY-MM-DD.md، ويلحق اختياريًا أفضل الإدخالات بـ MEMORY.md.

openclaw memory promote [--agent <id>] [--limit <n>] [--min-score <n>] \  [--min-recall-count <n>] [--min-unique-queries <n>] [--apply] [--include-promoted] [--json]

تختلف قيم CLI الافتراضية هذه عن حدود المرحلة العميقة لعملية مسح Dreaming المجدولة (راجع Dreaming أدناه)؛ مرّر علامات صريحة لمطابقة سلوك المسح عند تشغيل يدوي لمرة واحدة.

إشارات الترتيب: تكرار الاسترجاع، ومدى صلة الاسترداد، وتنوع الاستعلامات، والحداثة الزمنية، والدمج عبر الأيام، وثراء المفاهيم المشتقة، وتُستمد من عمليات استرجاع الذاكرة وعمليات الاستيعاب اليومية، بالإضافة إلى دفعة تعزيز طفيفة من مرحلتي الضوء/REM لزيارات Dreaming المتكررة. قبل الكتابة، تعيد عملية الترقية قراءة الملاحظة اليومية الحالية، وبذلك تُحترم التعديلات أو الحذف في المقاطع قصيرة الأمد منذ الترتيب بدلًا من الترقية من لقطة قديمة.

memory promote-explain

يشرح تفاصيل درجة أحد مرشحي الترقية.

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

يطابق <selector> مفتاح المرشح (مطابقة تامة أو جزئية)، أو مساره، أو نص المقطع.

memory rem-harness

يعاين تأملات REM والحقائق المرشحة ومخرجات ترقية المرحلة العميقة من دون كتابة أي شيء.

openclaw memory rem-harness [--agent <id>] [--path <file-or-dir>] [--grounded] [--include-promoted] [--json]

• --path <file-or-dir>: يهيئ حزمة الاختبار من الملفات اليومية التاريخية YYYY-MM-DD.md بدلًا من مساحة العمل الحالية.
• --grounded: يعرض أيضًا معاينة موثّقة للأقسام ما حدث / تأملات / تحديثات دائمة محتملة من الملاحظات التاريخية.

memory rem-backfill

يكتب ملخصات REM تاريخية موثّقة في DREAMS.md لمراجعتها في واجهة المستخدم. قابل للتراجع.

openclaw memory rem-backfill --path <file-or-dir> [--agent <id>] [--stage-short-term] [--json]openclaw memory rem-backfill --rollback [--rollback-short-term] [--json]

• --path <file-or-dir>: مطلوب ما لم يُحدد --rollback/--rollback-short-term. ملف (أو ملفات) ذاكرة يومية تاريخية أو دليل لملء البيانات منه بأثر رجعي.
• --stage-short-term: يضيف أيضًا مرشحين دائمين وموثّقين إلى مخزن الترقية قصير الأمد الحالي كي تتمكن المرحلة العميقة العادية من ترتيبهم.
• --rollback: يزيل إدخالات اليوميات الموثّقة المكتوبة سابقًا من DREAMS.md.
• --rollback-short-term: يزيل المرشحين الموثّقين قصيري الأمد الذين سبق إعدادهم.

Dreaming

Dreaming هو نظام دمج الذاكرة في الخلفية ويتألف من ثلاث مراحل متعاونة تعمل بالترتيب وفق جدول واحد: خفيفة (فرز/إعداد المواد قصيرة الأمد)، وREM (التأمل وإبراز الموضوعات)، وعميقة (ترقية الحقائق الدائمة إلى MEMORY.md). لا تكتب في MEMORY.md إلا المرحلة العميقة.

• فعّله باستخدام plugins.entries.memory-core.config.dreaming.enabled: true (القيمة الافتراضية false)؛ يدير memory-core مهمة Cron للمسح تلقائيًا، ولا يلزم تنفيذ openclaw cron add يدويًا.
• بدّل حالته من المحادثة باستخدام /dreaming on|off؛ وافحصه باستخدام /dreaming status (أو /dreaming//dreaming help). يتطلب on/off حالة مالك القناة أو صلاحية operator.admin في Gateway؛ وتظل الحالة والمساعدة متاحتين لكل من يمكنه استدعاء الأمر.
• تُكتب مخرجات المراحل المقروءة للبشر في DREAMS.md (أو ملف dreams.md موجود). افتراضيًا (dreaming.storage.mode: "separate")، تكتب كل مرحلة أيضًا تقريرًا مستقلًا في memory/dreaming/<phase>/YYYY-MM-DD.md؛ اضبط mode: "inline" لدمج التقارير في ملف الذاكرة اليومي بدلًا من ذلك، أو "both" لاستخدام الخيارين معًا.
• تشترك عمليات memory promote المجدولة واليدوية في إشارات ترتيب المرحلة العميقة نفسها؛ ولا تختلف إلا الحدود الافتراضية (راجع الجدول أعلاه مقابل القيم المجدولة الافتراضية أدناه).
• تتوزع عمليات التشغيل المجدولة على مساحات عمل الذاكرة لكل الوكلاء المُعدّين.

القيم المجدولة الافتراضية (plugins.entries.memory-core.config.dreaming):

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

القائمة الكاملة للمفاتيح وتفاصيل المراحل: Dreaming، ومرجع إعدادات الذاكرة.

اعتماد Gateway لـ SecretRef

إذا كانت حقول مفتاح API البعيد للذاكرة النشطة مُعدّة بصيغة SecretRefs، فإن أوامر memory تحلّها من لقطة Gateway النشطة؛ وإذا لم يكن Gateway متاحًا، يفشل الأمر فورًا. يتطلب ذلك Gateway يدعم الطريقة secrets.resolve؛ وتُرجع إصدارات Gateway الأقدم خطأ يفيد بأن الطريقة غير معروفة.

ذو صلة

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