---
read_when:
    - تريد فهم كيفية عمل الذاكرة
    - تريد معرفة ملفات الذاكرة التي ينبغي كتابتها
summary: كيف يتذكر OpenClaw الأشياء عبر الجلسات
title: نظرة عامة على الذاكرة
x-i18n:
    generated_at: "2026-05-10T19:33:39Z"
    model: gpt-5.5
    provider: openai
    source_hash: ef7a67b06615897167d7aac8a9f52fe7df9eee86f5d8d1504291ec750e674833
    source_path: concepts/memory.md
    workflow: 16
---

OpenClaw يتذكر الأشياء عبر كتابة **ملفات Markdown عادية** في مساحة عمل وكيلك. النموذج لا "يتذكر" إلا ما يتم حفظه على القرص — لا توجد حالة مخفية.

## كيف يعمل

لدى وكيلك ثلاثة ملفات مرتبطة بالذاكرة:

- **`MEMORY.md`** — ذاكرة طويلة الأمد. حقائق وتفضيلات وقرارات دائمة. يتم تحميلها عند بداية كل جلسة رسالة مباشرة.
- **`memory/YYYY-MM-DD.md`** — ملاحظات يومية. سياق وملاحظات جارية. يتم تحميل ملاحظات اليوم والأمس تلقائيًا.
- **`DREAMS.md`** (اختياري) — يوميات Dream وملخصات مسح Dreaming للمراجعة البشرية، بما في ذلك إدخالات الاستكمال التاريخي المؤسَّسة.

توجد هذه الملفات في مساحة عمل الوكيل (افتراضيًا `~/.openclaw/workspace`).

## ما الذي يوضع أين

`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` لمعرفة الأحجام الخام مقابل المحقونة وحالة الاقتطاع.

<Tip>
إذا أردت أن يتذكر وكيلك شيئًا، فاطلب منه ذلك مباشرة: "تذكر أنني أفضل TypeScript." سيكتبه في الملف المناسب.
</Tip>

## الالتزامات المستنتجة

بعض المتابعات المستقبلية ليست حقائق دائمة. إذا ذكرت مقابلة غدًا، فقد تكون الذاكرة المفيدة هي "تحقق بعد المقابلة"، لا "احفظ هذا إلى الأبد في `MEMORY.md`."

[الالتزامات](/ar/concepts/commitments) هي ذكريات متابعة اختيارية وقصيرة العمر لهذه الحالة. يستنتجها OpenClaw في تمريرة خلفية مخفية، ويقصرها على الوكيل والقناة نفسهما، ويسلم تسجيلات الوصول المستحقة عبر Heartbeat. التذكيرات الصريحة لا تزال تستخدم [المهام المجدولة](/ar/automation/cron-jobs).

## أدوات الذاكرة

لدى الوكيل أداتان للعمل مع الذاكرة:

- **`memory_search`** — تعثر على الملاحظات ذات الصلة باستخدام البحث الدلالي، حتى عندما تختلف الصياغة عن الأصل.
- **`memory_get`** — تقرأ ملف ذاكرة محددًا أو نطاقًا من الأسطر.

تُوفر كلتا الأداتين من خلال Plugin الذاكرة النشطة (الافتراضي: `memory-core`).

## Plugin الرفيق Memory Wiki

إذا أردت أن تتصرف الذاكرة الدائمة كقاعدة معرفة مُدارة أكثر من كونها مجرد ملاحظات خام، فاستخدم Plugin المضمن `memory-wiki`.

يجمع `memory-wiki` المعرفة الدائمة في خزنة ويكي تتضمن:

- بنية صفحات حتمية
- ادعاءات وأدلة منظمة
- تتبع التناقضات والحداثة
- لوحات معلومات مولدة
- ملخصات مجمعة لمستهلكي الوكيل/وقت التشغيل
- أدوات أصلية للويكي مثل `wiki_search` و`wiki_get` و`wiki_apply` و`wiki_lint`

لا يستبدل Plugin الذاكرة النشطة. لا يزال Plugin الذاكرة النشطة يملك الاستدعاء، والترقية، وDreaming. يضيف `memory-wiki` طبقة معرفة غنية بالمصدرية إلى جانبه.

راجع [Memory Wiki](/ar/plugins/memory-wiki).

## البحث في الذاكرة

عند تكوين موفر تضمينات، يستخدم `memory_search` **بحثًا هجينًا** — يجمع بين تشابه المتجهات (المعنى الدلالي) ومطابقة الكلمات المفتاحية (المصطلحات الدقيقة مثل المعرفات ورموز الكود). يعمل هذا مباشرة بمجرد أن يكون لديك مفتاح API لأي موفر مدعوم.

<Info>
يكتشف OpenClaw موفر التضمينات تلقائيًا من مفاتيح API المتاحة. إذا كان لديك مفتاح OpenAI أو Gemini أو Voyage أو Mistral مكوَّن، يتم تمكين البحث في الذاكرة تلقائيًا.
</Info>

للحصول على تفاصيل حول كيفية عمل البحث، وخيارات الضبط، وإعداد الموفرين، راجع [البحث في الذاكرة](/ar/concepts/memory-search).

## خلفيات الذاكرة

<CardGroup cols={3}>
<Card title="مدمجة (افتراضي)" icon="database" href="/ar/concepts/memory-builtin">
قائمة على SQLite. تعمل مباشرة مع البحث بالكلمات المفتاحية، وتشابه المتجهات، والبحث الهجين. لا توجد تبعيات إضافية.
</Card>
<Card title="QMD" icon="search" href="/ar/concepts/memory-qmd">
خدمة جانبية محلية أولًا مع إعادة ترتيب النتائج، وتوسيع الاستعلامات، والقدرة على فهرسة أدلة خارج مساحة العمل.
</Card>
<Card title="Honcho" icon="brain" href="/ar/concepts/memory-honcho">
ذاكرة أصلية للذكاء الاصطناعي عبر الجلسات مع نمذجة المستخدم، والبحث الدلالي، والوعي بعدة وكلاء. تثبيت Plugin.
</Card>
<Card title="LanceDB" icon="layers" href="/ar/plugins/memory-lancedb">
ذاكرة مضمنة مدعومة بـ LanceDB مع تضمينات متوافقة مع OpenAI، واستدعاء تلقائي، والتقاط تلقائي، ودعم تضمينات Ollama المحلية.
</Card>
</CardGroup>

## طبقة ويكي المعرفة

<CardGroup cols={1}>
<Card title="Memory Wiki" icon="book" href="/ar/plugins/memory-wiki">
تجمع الذاكرة الدائمة في خزنة ويكي غنية بالمصدرية مع ادعاءات، ولوحات معلومات، ووضع جسر، وتدفقات عمل ملائمة لـ Obsidian.
</Card>
</CardGroup>

## تفريغ الذاكرة التلقائي

قبل أن يلخص [Compaction](/ar/concepts/compaction) محادثتك، يشغّل OpenClaw دورًا صامتًا يذكّر الوكيل بحفظ السياق المهم في ملفات الذاكرة. هذا مفعّل افتراضيًا — لا تحتاج إلى تكوين أي شيء.

لإبقاء دور الصيانة هذا على نموذج محلي، عيّن تجاوزًا دقيقًا لنموذج تفريغ الذاكرة:

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

ينطبق التجاوز فقط على دور تفريغ الذاكرة ولا يرث سلسلة بدائل الجلسة النشطة.

<Tip>
يمنع تفريغ الذاكرة فقدان السياق أثناء Compaction. إذا كانت لدى وكيلك حقائق مهمة في المحادثة لم تُكتب بعد إلى ملف، فسيتم حفظها تلقائيًا قبل حدوث الملخص.
</Tip>

## Dreaming

Dreaming هو تمريرة دمج خلفية اختيارية للذاكرة. يجمع الإشارات قصيرة الأمد، ويسجل المرشحين، ويرقّي فقط العناصر المؤهلة إلى الذاكرة طويلة الأمد (`MEMORY.md`).

صُمم للحفاظ على الذاكرة طويلة الأمد عالية الإشارة:

- **اختياري**: معطل افتراضيًا.
- **مجدول**: عند تمكينه، يدير `memory-core` تلقائيًا مهمة Cron متكررة واحدة لمسح Dreaming كامل.
- **بعتبات**: يجب أن تجتاز الترقيات بوابات الدرجة، وتكرار الاستدعاء، وتنوع الاستعلامات.
- **قابل للمراجعة**: تُكتب ملخصات المراحل وإدخالات اليوميات إلى `DREAMS.md` للمراجعة البشرية.

لسلوك المراحل، وإشارات التسجيل، وتفاصيل يوميات Dream، راجع [Dreaming](/ar/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
```

لا تتم ترقية المرشحين الدائمين المؤسَّسين مباشرة. بل تُهيأ في مخزن 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
```

## قراءة إضافية

- [محرك الذاكرة المدمج](/ar/concepts/memory-builtin): خلفية SQLite الافتراضية.
- [محرك ذاكرة QMD](/ar/concepts/memory-qmd): خدمة جانبية متقدمة محلية أولًا.
- [ذاكرة Honcho](/ar/concepts/memory-honcho): ذاكرة أصلية للذكاء الاصطناعي عبر الجلسات.
- [Memory LanceDB](/ar/plugins/memory-lancedb): Plugin مدعوم بـ LanceDB مع تضمينات متوافقة مع OpenAI.
- [Memory Wiki](/ar/plugins/memory-wiki): خزنة معرفة مجمعة وأدوات أصلية للويكي.
- [البحث في الذاكرة](/ar/concepts/memory-search): مسار البحث، والموفرون، والضبط.
- [Dreaming](/ar/concepts/dreaming): ترقية خلفية من الاستدعاء قصير الأمد إلى الذاكرة طويلة الأمد.
- [مرجع تكوين الذاكرة](/ar/reference/memory-config): كل مقابض التكوين.
- [Compaction](/ar/concepts/compaction): كيف يتفاعل Compaction مع الذاكرة.

## ذو صلة

- [Active memory](/ar/concepts/active-memory)
- [البحث في الذاكرة](/ar/concepts/memory-search)
- [محرك الذاكرة المدمج](/ar/concepts/memory-builtin)
- [ذاكرة Honcho](/ar/concepts/memory-honcho)
- [Memory LanceDB](/ar/plugins/memory-lancedb)
- [الالتزامات](/ar/concepts/commitments)