---
read_when:
    - تريد فهرسة الذاكرة الدلالية أو البحث فيها
    - أنت تصحح أخطاء إتاحة الذاكرة أو فهرستها
    - تريد ترقية الذاكرة قصيرة الأمد المسترجعة إلى `MEMORY.md`
summary: مرجع CLI لـ `openclaw memory` ‏(الحالة/الفهرس/البحث/الترقية/شرح الترقية/مجموعة اختبار rem/الملء الرجعي لـ rem)
title: الذاكرة
x-i18n:
    generated_at: "2026-07-12T05:41:50Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: f0002c48044455520f32a5a3e111415a746fbafba2a27a655ded90abdc94623b
    source_path: cli/memory.md
    workflow: 16
---

# `openclaw memory`

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

ذو صلة: مفهوم [الذاكرة](/ar/concepts/memory)، و[Dreaming](/ar/concepts/dreaming)،
و[مرجع إعدادات الذاكرة](/ar/reference/memory-config)، و[ويكي الذاكرة](/ar/plugins/memory-wiki)،
و[الويكي](/ar/cli/wiki)، و[Plugins](/ar/tools/plugin).

## `memory status`

```bash
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](/ar/concepts/dreaming) للاطلاع على تفاصيل الجدولة.

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

## `memory index`

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

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

## `memory search`

```bash
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`.

```bash
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](#dreaming) أدناه)؛ مرّر علامات صريحة لمطابقة
سلوك المسح عند تشغيل يدوي لمرة واحدة.

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

## `memory promote-explain`

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

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

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

## `memory rem-harness`

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

```bash
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` لمراجعتها في واجهة المستخدم.
قابل للتراجع.

```bash
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`             |

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

القائمة الكاملة للمفاتيح وتفاصيل المراحل: [Dreaming](/ar/concepts/dreaming)،
و[مرجع إعدادات الذاكرة](/ar/reference/memory-config#dreaming).

## اعتماد Gateway لـ SecretRef

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

## ذو صلة

- [مرجع CLI](/ar/cli)
- [نظرة عامة على الذاكرة](/ar/concepts/memory)