---
read_when:
    - می‌خواهید حافظهٔ معنایی را نمایه‌سازی یا جست‌وجو کنید
    - در حال اشکال‌زدایی از دسترس‌پذیری حافظه یا نمایه‌سازی هستید
    - می‌خواهید حافظهٔ کوتاه‌مدتِ بازیابی‌شده را به `MEMORY.md` ارتقا دهید
summary: مرجع CLI برای `openclaw memory` (وضعیت/نمایه/جست‌وجو/ارتقا/توضیح ارتقا/ابزار آزمون rem/پرکردن سوابق rem)
title: حافظه
x-i18n:
    generated_at: "2026-07-12T09:47:32Z"
    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` (گزینهٔ پیش‌فرض) را انتخاب کند. سایر Pluginهای
حافظه، فضای نام CLI مختص خود را ارائه می‌کنند.

مطالب مرتبط: مفهوم [حافظه](/fa/concepts/memory)، [Dreaming](/fa/concepts/dreaming)،
[مرجع پیکربندی حافظه](/fa/reference/memory-config)، [ویکی حافظه](/fa/plugins/memory-wiki)،
[ویکی](/fa/cli/wiki)، [Pluginها](/fa/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` حتی با `dreaming.enabled: true` همچنان `off` باقی می‌ماند، یا
به نظر می‌رسد پیمایش‌های زمان‌بندی‌شده هرگز اجرا نمی‌شوند، Cron مدیریت‌شدهٔ Dreaming
برای فعال‌کردن تطبیق به اجرای Heartbeat عامل پیش‌فرض وابسته است. برای جزئیات
زمان‌بندی، [Dreaming](/fa/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 نیاز دارد؛
  `status` و راهنما برای هر کسی که بتواند فرمان را فراخوانی کند در دسترس
  باقی می‌مانند.
- خروجی خوانای هر مرحله برای انسان در `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](/fa/concepts/dreaming)،
[مرجع پیکربندی حافظه](/fa/reference/memory-config#dreaming).

## وابستگی Gateway برای SecretRef

اگر فیلدهای کلید API راه‌دور حافظهٔ فعال به‌صورت SecretRef پیکربندی شده باشند،
فرمان‌های `memory` آن‌ها را از تصویر لحظه‌ای Gateway فعال دریافت می‌کنند؛ اگر
Gateway در دسترس نباشد، فرمان بلافاصله با خطا متوقف می‌شود. این قابلیت به
Gatewayای نیاز دارد که از متد `secrets.resolve` پشتیبانی کند؛ Gatewayهای قدیمی‌تر
خطای ناشناخته بودن متد را برمی‌گردانند.

## مرتبط

- [مرجع CLI](/fa/cli)
- [نمای کلی حافظه](/fa/concepts/memory)