---
read_when:
    - تريد أن تفهم كيفية عمل الذاكرة
    - تريد معرفة ملفات الذاكرة التي يجب كتابتها
summary: كيف يتذكر OpenClaw الأشياء عبر الجلسات
title: نظرة عامة على الذاكرة
x-i18n:
    generated_at: "2026-04-15T14:40:31Z"
    model: gpt-5.4
    provider: openai
    source_hash: ad1adafe1d81f1703d24f48a9c9da2b25a0ebbd4aad4f65d8bde5df78195d55b
    source_path: concepts/memory.md
    workflow: 15
---

# نظرة عامة على الذاكرة

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

## كيف يعمل

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

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

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

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

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

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

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

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

## Plugin المصاحب Memory Wiki

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

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

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

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

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

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

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

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

للتفاصيل حول كيفية عمل البحث، وخيارات الضبط، وإعداد الموفر، راجع
[Memory Search](/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>
</CardGroup>

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

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

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

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

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

## Dreaming

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

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

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

للاطلاع على سلوك المراحل، وإشارات التقييم، وتفاصيل يوميات الأحلام، راجع
[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          # تحقق من حالة الفهرس والموفر
openclaw memory search "query"  # ابحث من سطر الأوامر
openclaw memory index --force   # أعد بناء الفهرس
```

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

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