---
read_when:
    - می‌خواهید بدانید حافظه چگونه کار می‌کند
    - می‌خواهید بدانید در کدام فایل‌های حافظه بنویسید
summary: OpenClaw چگونه اطلاعات را در نشست‌های مختلف به خاطر می‌سپارد
title: نمای کلی حافظه
x-i18n:
    generated_at: "2026-07-12T09:50:40Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: c77d71dd6b1916b923fbf72c373f20128c4f604f96cc76150ea27e0f13a541f8
    source_path: concepts/memory.md
    workflow: 16
---

OpenClaw با نوشتن فایل‌های سادهٔ Markdown در فضای کاری عامل شما
(پیش‌فرض: `~/.openclaw/workspace`) اطلاعات را به خاطر می‌سپارد. مدل فقط چیزهایی را به خاطر می‌سپارد که
روی دیسک ذخیره شده‌اند؛ هیچ وضعیت پنهانی وجود ندارد.

## نحوهٔ کار

عامل شما سه فایل مرتبط با حافظه دارد:

- **`MEMORY.md`** — حافظهٔ بلندمدت. واقعیت‌ها، ترجیحات و
  تصمیم‌های ماندگار. در آغاز هر نشست بارگذاری می‌شود.
- **`memory/YYYY-MM-DD.md`** (یا `memory/YYYY-MM-DD-<slug>.md`) — یادداشت‌های روزانه.
  زمینه و مشاهدات جاری. یادداشت‌های تاریخ‌دار امروز و دیروز
  به‌طور خودکار هنگام اجرای سادهٔ `/new` یا `/reset` بارگذاری می‌شوند؛ گونه‌های دارای نامک، مانند مواردی
  که هوک همراهِ حافظهٔ نشست می‌نویسد، در کنار فایلِ فقط‌تاریخ
  دریافت می‌شوند.
- **`DREAMS.md`** (اختیاری) — دفترچهٔ رؤیا و خلاصه‌های پیمایش Dreaming برای
  بازبینی انسانی، شامل ورودی‌های بازافزایی تاریخیِ مبتنی بر شواهد.

<Tip>
اگر می‌خواهید عامل شما چیزی را به خاطر بسپارد، کافی است از آن بخواهید: «به خاطر بسپار که من
TypeScript را ترجیح می‌دهم.» عامل یادداشت را در فایل مناسب می‌نویسد.
</Tip>

## چه چیزی کجا قرار می‌گیرد

`MEMORY.md` لایهٔ فشرده و گزینش‌شده است: واقعیت‌ها، ترجیحات، تصمیم‌های
پایدار و خلاصه‌های کوتاهی که باید در آغاز یک
نشست در دسترس باشند. این فایل رونوشت خام، گزارش روزانه یا بایگانی جامع نیست.

فایل‌های `memory/YYYY-MM-DD.md` لایهٔ کاری هستند: یادداشت‌های روزانهٔ مفصل،
مشاهدات، خلاصه‌های نشست و زمینهٔ خامی که ممکن است بعداً همچنان مفید
باشد. این فایل‌ها برای `memory_search` و `memory_get` نمایه‌سازی می‌شوند، اما
در هر نوبت به اعلان راه‌اندازی تزریق نمی‌شوند.

با گذشت زمان، عامل مطالب مفید را از یادداشت‌های روزانه استخراج و در
`MEMORY.md` ثبت می‌کند و ورودی‌های بلندمدتِ منسوخ را حذف می‌کند. دستورالعمل‌های تولیدشدهٔ فضای کاری
و جریان Heartbeat این کار را دوره‌ای انجام می‌دهند؛ لازم نیست برای
هر جزئیات، `MEMORY.md` را به‌صورت دستی ویرایش کنید.

اگر اندازهٔ `MEMORY.md` از بودجهٔ فایل راه‌اندازی فراتر رود، OpenClaw فایل را روی
دیسک دست‌نخورده نگه می‌دارد، اما نسخهٔ تزریق‌شده به زمینه را کوتاه می‌کند. این وضعیت را
نشانه‌ای در نظر بگیرید برای انتقال مطالب مفصل به `memory/*.md`، نگه‌داشتن فقط یک
خلاصهٔ ماندگار در `MEMORY.md`، یا افزایش محدودیت‌های راه‌اندازی در صورتی که می‌خواهید بودجهٔ بیشتری
از اعلان مصرف کنید. برای مشاهدهٔ اندازه‌های خام و تزریق‌شده و وضعیت کوتاه‌سازی، از
`/context list`، `/context detail` یا `openclaw doctor` استفاده کنید.

## حافظه‌های حساس به اقدام

بیشتر حافظه‌ها یادداشت‌های معمولی Markdown هستند. برخی بر کاری که عامل باید
بعداً انجام دهد اثر می‌گذارند؛ برای این موارد، فقط خود واقعیت را ثبت نکنید، بلکه مشخص کنید چه زمانی اقدام بر اساس یادداشت امن است.

این مرز اقدام را زمانی ثبت کنید که یک یادداشت شامل موارد زیر است:

- الزامات تأیید یا مجوز،
- محدودیت‌های موقت،
- واگذاری به نشست، رشته یا شخصی دیگر،
- شرایط انقضا،
- زمان امن برای اقدام،
- مرجع یا اختیار مالک،
- دستورالعمل‌هایی برای خودداری از اقدامی وسوسه‌انگیز.

یک حافظهٔ مفیدِ حساس به اقدام به‌روشنی مشخص می‌کند:

- چه چیزی رفتار آینده را تغییر می‌دهد،
- چه زمانی یا تحت چه شرایطی اعمال می‌شود،
- چه زمانی منقضی می‌شود یا چه چیزی اجازهٔ اقدام را صادر می‌کند،
- عامل باید از انجام چه کاری خودداری کند،
- منبع یا مالک چه کسی است، اگر این موضوع بر اعتماد یا اختیار اثر می‌گذارد.

حافظه می‌تواند زمینهٔ تأیید را حفظ کند، اما سیاست را اعمال نمی‌کند. برای کنترل‌های
عملیاتی سخت‌گیرانه از تنظیمات تأیید OpenClaw، محیط ایزوله و وظایف زمان‌بندی‌شده استفاده کنید.

مثال:

```md
The API migration is being designed in another session. Future turns should
not edit the API implementation from this thread; use findings here only as
design input until the migration plan lands.
```

مثالی دیگر:

```md
A report from an untrusted source needs review before promotion. Future turns
should treat it as evidence only; do not store it as durable memory until a
trusted reviewer confirms the contents.
```

این ساختار برای همهٔ حافظه‌ها الزامی نیست؛ واقعیت‌های ساده می‌توانند مختصر بمانند.
زمانی از مرزهای حساس به اقدام استفاده کنید که از دست رفتن زمان‌بندی، اختیار، انقضا یا
زمینهٔ امن برای اقدام ممکن است باعث شود عامل بعداً کار اشتباهی انجام دهد.

برای پیگیری‌های استنباط‌شده و کوتاه‌مدت از [تعهدات](/fa/concepts/commitments) استفاده کنید.
برای یادآوری‌های دقیق، بررسی‌های زمان‌بندی‌شده و کارهای تکرارشونده از [وظایف زمان‌بندی‌شده](/fa/automation/cron-jobs) استفاده کنید.
حافظه همچنان می‌تواند زمینهٔ ماندگار پیرامون هر یک از این مسیرها را خلاصه کند.

## تعهدات استنباط‌شده

برخی پیگیری‌های آینده واقعیت‌های ماندگار نیستند. اگر به مصاحبه‌ای در
فردا اشاره کنید، حافظهٔ مفید ممکن است «پس از مصاحبه پیگیری کن» باشد، نه «این را
برای همیشه در `MEMORY.md` ذخیره کن.»

[تعهدات](/fa/concepts/commitments) حافظه‌های پیگیریِ اختیاری و کوتاه‌مدت
برای چنین مواردی هستند. OpenClaw آن‌ها را در یک گذر پس‌زمینهٔ پنهان استنباط می‌کند،
دامنه‌شان را به همان عامل و کانال محدود می‌کند و پیگیری‌های سررسیدشده را از طریق
Heartbeat تحویل می‌دهد. یادآوری‌های صریح همچنان از [وظایف زمان‌بندی‌شده](/fa/automation/cron-jobs) استفاده می‌کنند.

## ابزارهای حافظه

عامل دو ابزار برای کار با حافظه دارد:

- **`memory_search`** — با استفاده از جست‌وجوی معنایی، یادداشت‌های مرتبط را پیدا می‌کند، حتی وقتی
  عبارت‌بندی با متن اصلی متفاوت باشد.
- **`memory_get`** — یک فایل حافظه یا محدودهٔ خطوط مشخص را می‌خواند.

هر دو ابزار توسط Plugin فعال حافظه ارائه می‌شوند (پیش‌فرض: `memory-core`).

## جست‌وجوی حافظه

وقتی یک ارائه‌دهندهٔ تعبیه‌سازی پیکربندی شده باشد، `memory_search` از جست‌وجوی ترکیبی استفاده می‌کند:
شباهت برداری (معنای مفهومی) همراه با تطبیق کلیدواژه‌ها (عبارت‌های دقیق
مانند شناسه‌ها و نمادهای کد). این قابلیت با کلید API هر
ارائه‌دهندهٔ پشتیبانی‌شده، بدون تنظیمات اضافی کار می‌کند.

<Info>
OpenClaw به‌طور پیش‌فرض از تعبیه‌سازی‌های OpenAI استفاده می‌کند. برای استفاده از Gemini، Voyage،
Mistral، Bedrock، DeepInfra، فایل محلی GGUF، Ollama، LM Studio، GitHub Copilot یا
یک نقطهٔ پایانی عمومیِ سازگار با OpenAI، مقدار
`agents.defaults.memorySearch.provider` را صریحاً تنظیم کنید.
</Info>

برای آشنایی با نحوهٔ کار جست‌وجو، گزینه‌های تنظیم و راه‌اندازی
ارائه‌دهنده، به [جست‌وجوی حافظه](/fa/concepts/memory-search) مراجعه کنید.

## پسانه‌های حافظه

<CardGroup cols={3}>
<Card title="داخلی (پیش‌فرض)" icon="database" href="/fa/concepts/memory-builtin">
مبتنی بر SQLite. بدون تنظیمات اضافی با جست‌وجوی کلیدواژه‌ای، شباهت برداری و
جست‌وجوی ترکیبی کار می‌کند. وابستگی اضافی ندارد.
</Card>
<Card title="QMD" icon="search" href="/fa/concepts/memory-qmd">
سرویس جانبی با اولویت اجرای محلی، همراه با رتبه‌بندی مجدد، گسترش پرس‌وجو و امکان نمایه‌سازی
پوشه‌های خارج از فضای کاری.
</Card>
<Card title="Honcho" icon="brain" href="/fa/concepts/memory-honcho">
حافظهٔ میان‌نشستی بومیِ هوش مصنوعی با مدل‌سازی کاربر، جست‌وجوی معنایی و
آگاهی چندعاملی. نیازمند نصب Plugin.
</Card>
<Card title="LanceDB" icon="layers" href="/fa/plugins/memory-lancedb">
حافظهٔ مبتنی بر LanceDB با تعبیه‌سازی‌های سازگار با OpenAI، یادآوری خودکار،
ثبت خودکار و پشتیبانی از تعبیه‌سازی محلی Ollama. نیازمند نصب Plugin.
</Card>
</CardGroup>

## لایهٔ ویکی دانش

اگر می‌خواهید حافظهٔ ماندگار بیشتر شبیه یک پایگاه دانش نگه‌داری‌شده
عمل کند تا مجموعه‌ای از یادداشت‌های خام، از Plugin همراهِ `memory-wiki` استفاده کنید. این Plugin دانش ماندگار را
در یک مخزن ویکی با ساختار صفحهٔ قطعی، ادعاها و شواهد ساخت‌یافته، ردیابی
تعارض و تازگی، داشبوردهای تولیدشده، چکیده‌های تدوین‌شده و ابزارهای
بومی ویکی (`wiki_status`، `wiki_search`، `wiki_get`، `wiki_apply`، `wiki_lint`) گردآوری می‌کند.

`memory-wiki` جایگزین Plugin فعال حافظه نمی‌شود؛ Plugin فعال حافظه
همچنان مالک یادآوری، ارتقا و Dreaming است. `memory-wiki` یک
لایهٔ دانش غنی از منشأ را در کنار آن اضافه می‌کند.

<CardGroup cols={1}>
<Card title="ویکی حافظه" icon="book" href="/fa/plugins/memory-wiki">
حافظهٔ ماندگار را در یک مخزن ویکی غنی از منشأ، همراه با ادعاها،
داشبوردها، حالت پل و جریان‌های کاری سازگار با Obsidian گردآوری می‌کند.
</Card>
</CardGroup>

## تخلیهٔ خودکار حافظه

پیش از آنکه [Compaction](/fa/concepts/compaction) گفت‌وگوی شما را خلاصه کند،
OpenClaw یک نوبت بی‌صدا اجرا می‌کند که به عامل یادآوری می‌کند زمینهٔ مهم
را در فایل‌های حافظه ذخیره کند. این قابلیت به‌طور پیش‌فرض فعال است؛ برای غیرفعال‌کردن آن
`agents.defaults.compaction.memoryFlush.enabled: false` را تنظیم کنید.

برای اجرای آن نوبت نگه‌داری روی یک مدل محلی، یک بازنویسی دقیق تنظیم کنید که
فقط بر نوبت تخلیهٔ حافظه اعمال شود (این نوبت زنجیرهٔ مدل جایگزین
نشست فعال را به ارث نمی‌برد):

```json
{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}
```

<Tip>
تخلیهٔ حافظه از گم‌شدن زمینه هنگام Compaction جلوگیری می‌کند. اگر عامل شما
واقعیت‌های مهمی در گفت‌وگو داشته باشد که هنوز در فایلی نوشته نشده‌اند،
پیش از انجام خلاصه‌سازی به‌طور خودکار ذخیره می‌شوند.
</Tip>

## Dreaming

Dreaming یک گذر اختیاریِ پس‌زمینه برای یکپارچه‌سازی حافظه است. این فرایند
نشانه‌های یادآوری کوتاه‌مدت را جمع‌آوری می‌کند، به گزینه‌ها امتیاز می‌دهد و فقط موارد
واجد شرایط را به حافظهٔ بلندمدت (`MEMORY.md`) ارتقا می‌دهد:

- **اختیاری**: به‌طور پیش‌فرض غیرفعال است.
- **زمان‌بندی‌شده**: وقتی فعال باشد، `memory-core` یک کار Cron تکرارشونده
  را برای پیمایش کامل Dreaming به‌طور خودکار مدیریت می‌کند.
- **دارای آستانه**: ارتقاها باید از دروازه‌های امتیاز، بسامد یادآوری و
  تنوع پرس‌وجو عبور کنند.
- **قابل بازبینی**: خلاصه‌های مرحله و ورودی‌های دفترچه در
  `DREAMS.md` نوشته می‌شوند تا انسان آن‌ها را بازبینی کند.

برای جزئیات رفتار مرحله‌ها، نشانه‌های امتیازدهی و دفترچهٔ رؤیا، به
[Dreaming](/fa/concepts/dreaming) مراجعه کنید.

## بازافزایی مبتنی بر شواهد و ارتقای زنده

سامانهٔ Dreaming دو مسیر بازبینی مرتبط دارد:

- **Dreaming زنده** با مخزن کوتاه‌مدت Dreaming در
  `memory/.dreams/` کار می‌کند و همان چیزی است که مرحلهٔ عمیق عادی برای تصمیم‌گیری دربارهٔ
  انتقال موارد به `MEMORY.md` استفاده می‌کند.
- **بازافزایی مبتنی بر شواهد** یادداشت‌های تاریخی `memory/YYYY-MM-DD.md` را به‌عنوان
  فایل‌های روزانهٔ مستقل می‌خواند و خروجی بازبینی ساخت‌یافته را در `DREAMS.md` می‌نویسد.

بازافزایی مبتنی بر شواهد برای بازپخش یادداشت‌های قدیمی و بررسی اینکه سامانه چه چیزی را
ماندگار در نظر می‌گیرد مفید است، بدون آنکه لازم باشد `MEMORY.md` را به‌صورت دستی ویرایش کنید.

```bash
openclaw memory rem-backfill --path ./memory --stage-short-term
```

پرچم `--stage-short-term` گزینه‌های ماندگارِ مبتنی بر شواهد را در همان
مخزن کوتاه‌مدت Dreaming قرار می‌دهد که مرحلهٔ عمیق عادی از قبل استفاده می‌کند؛ این پرچم
آن‌ها را مستقیماً ارتقا نمی‌دهد. بنابراین:

- `DREAMS.md` سطح بازبینی انسانی باقی می‌ماند.
- مخزن کوتاه‌مدت سطح رتبه‌بندی برای ماشین باقی می‌ماند.
- `MEMORY.md` همچنان فقط توسط ارتقای عمیق نوشته می‌شود.

برای واگردانی یک بازپخش بدون دست‌زدن به ورودی‌های معمول دفترچه یا وضعیت عادی
یادآوری:

```bash
openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term
```

## CLI

```bash
openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index
```

## مطالعهٔ بیشتر

- [جست‌وجوی حافظه](/fa/concepts/memory-search): خط لولهٔ جست‌وجو، ارائه‌دهندگان و تنظیمات.
- [موتور داخلی حافظه](/fa/concepts/memory-builtin): پسانهٔ پیش‌فرض SQLite.
- [موتور حافظهٔ QMD](/fa/concepts/memory-qmd): سرویس جانبی پیشرفته با اولویت اجرای محلی.
- [حافظهٔ Honcho](/fa/concepts/memory-honcho): حافظهٔ میان‌نشستی بومیِ هوش مصنوعی.
- [حافظهٔ LanceDB](/fa/plugins/memory-lancedb): Plugin مبتنی بر LanceDB با تعبیه‌سازی‌های سازگار با OpenAI.
- [ویکی حافظه](/fa/plugins/memory-wiki): مخزن دانش گردآوری‌شده و ابزارهای بومی ویکی.
- [Dreaming](/fa/concepts/dreaming): ارتقای پس‌زمینه از یادآوری کوتاه‌مدت به حافظهٔ بلندمدت.
- [مرجع پیکربندی حافظه](/fa/reference/memory-config): همهٔ گزینه‌های پیکربندی.
- [Compaction](/fa/concepts/compaction): نحوهٔ تعامل Compaction با حافظه.
- [Active Memory](/fa/concepts/active-memory): حافظهٔ زیرعامل برای نشست‌های گفت‌وگوی تعاملی.