`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؛ وإذا لم تكن قائمة الوكلاء مُعدّة، فإنه يعود إلى الوكيل الافتراضي.

العلامة	التأثير
`--deep`	يتحقق من جاهزية مخزن المتجهات وموفّر التضمينات والبحث الدلالي (ويتضمن استدعاءات إضافية للموفّر). يظل `memory status` العادي سريعًا ويتجاوز ذلك؛ وتعني حالة المتجهات/الدلالة غير المعروفة أنه لم يُتحقق منها. يتجاوز وضع البحث المعجمي في QMD،‏ `searchMode: "search"`، عمليات التحقق من المتجهات الدلالية دائمًا، حتى مع `--deep`.
`--index`	يعيد الفهرسة إذا كان المخزن غير متزامن. يتضمن `--deep`.
`--fix`	يصلح أقفال الاسترجاع القديمة ويوحّد بيانات تعريف الترقية.
`--json`	يطبع JSON.
`--verbose`	يصدر سجلات مفصلة لكل مرحلة.

إذا ظل سطر 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]

العلامة	القيمة الافتراضية	التأثير
`--limit <n>`		الحد الأقصى للمرشحين المراد إرجاعهم/تطبيقهم.
`--min-score <n>`	`0.75`	الحد الأدنى لدرجة الترقية الموزونة.
`--min-recall-count <n>`	`3`	الحد الأدنى المطلوب لعدد مرات الاسترجاع.
`--min-unique-queries <n>`	`2`	الحد الأدنى المطلوب لعدد الاستعلامات المتميزة.
`--apply`	معاينة فقط	يلحق المرشحين المحددين بـ `MEMORY.md` ويضع علامة ترقية عليهم.
`--include-promoted`		يضمّن المرشحين الذين رُقّوا بالفعل في دورات سابقة.
`--json`		يطبع 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):

المفتاح	القيمة الافتراضية
`frequency`	`0 3 * * *`
`phases.deep.minScore`	`0.8`
`phases.deep.minRecallCount`	`3`
`phases.deep.minUniqueQueries`	`3`
`phases.deep.recencyHalfLifeDays`	`14`
`phases.deep.maxAgeDays`	`30`
`phases.deep.maxPromotedSnippetTokens`	`160`

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

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

اعتماد Gateway لـ SecretRef

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

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

الذاكرة

`openclaw memory`

`memory status`

`memory index`

`memory search`

`memory promote`

`memory promote-explain`

`memory rem-harness`

`memory rem-backfill`

Dreaming

اعتماد Gateway لـ SecretRef

ذو صلة

​openclaw memory

​memory status

​memory index

​memory search

​memory promote

​memory promote-explain

​memory rem-harness

​memory rem-backfill

​Dreaming

​اعتماد Gateway لـ SecretRef

​ذو صلة

`openclaw memory`

`memory status`

`memory index`

`memory search`

`memory promote`

`memory promote-explain`

`memory rem-harness`

`memory rem-backfill`

Dreaming

اعتماد Gateway لـ SecretRef

ذو صلة