نظام الذاكرة: اجعل Claw يتذكرك
كانت أوامر الدرس السابق «تسري فورًا»؛ أما هذا الدرس فيشرح كيف تجعل الأثريبقى. يمكن تلخيص فلسفة تصميم نظام الذاكرة في OpenClaw بجملة واحدة: لا حالة مخفية — Claw لا يتذكر إلا ما يُكتب على القرص، وما يُكتب على القرص هو ملفات Markdown نصية خالصة يمكنك فتحها بمحرر نصوص (افتراضيًا في ~/.openclaw/workspace).
وهذا يعني أمرين: لجعل Claw يتذكرك، قل ذلك صراحةً («تذكّر: أفضّل TypeScript»)؛ ولفحص ما يتذكره أو تعديله، افتح الملف واقرأه. يشرح هذا الدرس الكتابة والاستدعاء والتثبيت التلقائي والمشاركة عبر الجلسات والترحيل للذاكرة دفعة واحدة، وجميع الأمثلة مبنية على OpenClaw v2026.10.9.
ماذا ستستطيع أن تفعل بعد الدرس
- قول «تذكّر: …» ليكتب Claw تفضيلاتك وحقائقك في
USER.md/MEMORY.md - استخدام
/newلفتح جلسة جديدة والتحقق من بقاء الذاكرة عبر الجلسات، مع القدرة على تحديد الفاصل بين سياق الجلسة والذاكرة طويلة المدى - جعل Claw يستعيد المواضيع القديمة من طبقة اليوميات باستخدام
memory_search(بدعم أصلي للصينية عبر تقسيم trigram) - تفعيل الاستدعاء عبر الجلسات في 2.0: المحادثات الخاصة للوكيل نفسه تتذكر بعضها (مفعّل افتراضيًا في التثبيت الشخصي)
- فهم ما يفعله التثبيت التلقائي dreaming، واستيراد الذكريات القديمة من Claude Code / Codex / Hermes
معضلتك الحالية
- في كل مرة تفتح جلسة جديدة تعيد تقديم نفسك من جديد: «أستخدم TypeScript»، «أجب بالصينية»، «لا تطل»
- المعلومات التي بحث عنها الأسبوع الماضي والخطط التي حُددت، يسأل عنها هذا الأسبوع فيبدو بريئًا تمامًا: «لم نتحدث عن هذا»
- انتقلت من Claude Code، وهناك ذكريات تراكمت على مدى أشهر، فهل يعقل أن تبدأ التراكم من الصفر هنا؟
متى تستخدم هذه الحيلة
عندما تحتاج إلى:
- أن يتذكر Claw تفضيلاتك وخلفية مشاريعك وقراراتك عبر الجلسات
- أن يستطيع بنفسه تتبّع ملاحظاته القديمة للإجابة عن أسئلة مثل «كيف اتفقنا سابقًا؟»
- ذاكرة قابلة للفحص والتعديل — إذا حدثت مشكلة يمكنك فتح الملف وتعديله بيدك
ولا تريد:
- إعادة سرد المعرفة الخلفية في كل جلسة جديدة
- ائتمان الحقائق المهمة إلى «ذاكرة سحابية صندوق أسود» لا تُرى ولا تُلمس
- صيانة مستند تلميحات يدويًا يطول كلما كتبت فيه أكثر
🎒 التحضير قبل البدء
- أكملت دليل الاستخدام اليومي؛ إذا لم تكن معتادًا على مدخل المحادثة فاطّلع أولًا على Control UI: لوحة التحكم في المتصفح
- Gateway يعمل:
openclaw gateway statusيعرض حالة الاستماع (فهرسة الذاكرة واسترجاعها يوفرهما كلاهما ملحق memory-core على جانب Gateway) - إعداد مزوّد نماذج واحد على الأقل (إن لم يكن جاهزًا فاذهب أولًا إلى نظرة عامة على ربط النماذج)
- فتح أي مدخل محادثة: مربع محادثة Control UI، أو الطرفية
openclawللدخول إلى TUI، أو قناة محادثة متصلة سلفًا - (اختياري) لاستخدام البحث الدلالي: توفر embeddings متاح. الافتراضي هو OpenAI embeddings؛ ويمكن أيضًا التحويل إلى حلول محلية مثل Ollama أو الاكتفاء بالبحث بالكلمات المفتاحية (تفاصيل في الخطوة 3 وفي التقنيات المتقدمة)
الفكرة الجوهرية
ذاكرة OpenClaw = ملفات Markdown على القرص + فهرس SQLite. الملفات هي الجوهر، والفهرس من أجل الاسترجاع. النص الحرفي في الوثائق الرسمية: النموذج لا يتذكر إلا ما يُحفظ على القرص، ولا توجد حالة مخفية (there is no hidden state).
أربعة ملفات متعلقة بالذاكرة، كل منها مسؤول عن طبقة:
| الملف | ماذا يحتوي | متى يُحمّل |
|---|---|---|
USER.md (اختياري) | ملف تعريف المستخدم: التفضيلات المستقرة وأسلوب التواصل والعلاقات والمشاريع الجارية، مكتوبة كمدخلات توجيهية | يُحقن في بداية كل جلسة (بميزانية مستقلة صغيرة) |
MEMORY.md | الذاكرة طويلة المدى: الحقائق والقرارات والملخصات المستمرة غير المتعلقة بملف التعريف | تُحقن في بداية كل جلسة |
memory/YYYY-MM-DD.md | طبقة اليوميات: سياق العمل اليومي والملاحظات وملخصات الجلسات | يوميات اليوم والأمس تُحمّل تلقائيًا عند /new و /reset المجردَين؛ والأقدم منها تُسترجع عند الحاجة فقط |
DREAMS.md (اختياري) | تقارير أحلام dreaming، مكتوبة ليقرأها الإنسان | لا تُحقن أبدًا، للمراجعة فقط |
لدى Claw ثلاث أدوات للذاكرة (توفرها إضافة الذاكرة الافتراضية memory-core): memory_search (استرجاع دلالي، يصيب الهدف حتى مع اختلاف الصياغة)، وmemory_get (قراءة ملف محدد أو نطاق من الأسطر)، وintent (تسجيل تذكيرات مشروطة بالأحداث؛ أما التذكيرات الزمنية فتذهب إلى المهام المجدولة ولا تتبع الذاكرة).
خطان أساسيان في التصميم، معرفتهما مبكرًا تقيك الوقوع في المطبات:
- الكتابة في الذاكرة لها عتبة، فليس كل شيء يُسجَّل. كل ذكرى تحمل علامة تتبع للمصدر:
owner(ما قلته بنفسك في قناة موثوقة)،agent(ما استنتجه Claw من محتواك)،untrusted(محتوى خارجي من صفحات الويب ومخرجات الأدوات ومحادثات المجموعات)،system(تعليمات وقت التشغيل). الفئتان الأخيرتان لن تُرقَّيا أبدًا إلى الذاكرة طويلة الأمد — هذا حجب هيكلي، وليس «حذرًا احتماليًا». لذا إذا أردت أن يتذكر Claw شيئًا، فأفضل طريقة أن تقوله بنفسك. - الاستدعاء يسير في مسارين. المسار الرخيص بلا أي استدعاء للنموذج: حقن
USER.md/MEMORY.mdعند بدء الجلسة، واسترجاع مرتَّب عبرmemory_search، وحقن تلقائي عند العبارات المُفعِّلة (بحد أقصى 3 مداخل لكل دور). أما المسار المكلف فهو وكيل Active Memory الفرعي، الذي لا يُستدعى إلا «عندما تسأل عن أمور الماضي ولا يجد المسار الرخيص تطابقًا قويًا» — فالدردشة اليومية لا تدفع كلفة تأخير إضافية من أجل التذكر.
💡 الذاكرة ≠ التذكير
التذكيرات الزمنية مثل «ذكّرني بمراجعة البيانات يوم الجمعة بعد الظهر» لا تدخل نظام الذاكرة؛ يحوّلها Claw إلى مهمة cron مجدولة. أما التذكيرات الحدثية مثل «نبّهني عندما يصدر الـ release» فتذهب عبر أداة intent إلى جدول SQLite مستقل. الذاكرة تختص بـ «تذكر الحقائق»، والمهام المجدولة بـ «فعل الشيء في وقته» — للتفاصيل راجع المهام المجدولة Automations.
طبّق معي
الخطوة 1: اجعل Claw يتذكرك — قل «تذكّر» مباشرة
لماذا: OpenClaw الذاكرة بلا حالة خفية؛ إذا أردت أن يتذكر Claw شيئًا، فلا تحتاج إلى أي أمر أو إعداد — أخبره مباشرة. مثال الوثائق الرسمية هو جملة واحدة: "Remember that I prefer TypeScript."
أرسل رسالة في أي مدخل محادثة:
تذكّر: أستخدم TypeScript بشكل أساسي، واكتب أمثلة الشيفرة بـ TypeScript افتراضيًا.ينبغي أن ترى: يؤكد Claw أنه سجّل الملاحظة، ويكتب هذا المدخل في ملف الذاكرة تحت ~/.openclaw/workspace — التفضيلات وما شابهها من الصور الثابتة تُكتب بحسب الاتفاقية كمداخل بصيغة أوامر (تبدأ بـ Always / Never / Prefer) وتوضع في USER.md؛ أما الحقائق والقرارات غير المتعلقة بالصورة الشخصية فتوضع في MEMORY.md. أي ملف تحديدًا يقرره Claw بمعيار «الملف المناسب».
لترى بعينك، اذهب وألقِ نظرة في الملف:
cat ~/.openclaw/workspace/USER.mdينبغي أن ترى: مدخل جديد بصيغة أمر، عادةً مع تاريخ الملاحظة. USER.md نفسه ملف اختياري؛ إن لم يكن موجودًا من قبل فستنشئه هذه الكتابة. إن لم ترغب في فتح الطرفية، يمكنك أيضًا المشاهدة من Control UI عبر صفحة Agents ← تبويب Memory (وهناك أيضًا مفتاح حالة dreaming وقارئ Dream Diary).
💡 إذا أخطأ التذكر فقل ذلك مباشرة
إذا تغيّرت تفضيلاتك فأخبره مباشرة: «أستخدم Python أكثر الآن». بحسب الاتفاقية الرسمية، تحديث التفضيلات في USER.md هو استبدال في المكان للمدخل القديم، وليس إضافة مدخل متناقض — وإلا فسيجيبك Claw بالقيمة القديمة.
- رأيت في
USER.md(أوMEMORY.md) المدخل الذي كُتب للتو
الخطوة 2: تحقّق من الذاكرة عبر الجلسات — يتذكر بعد /new
لماذا: معيار «أنه يتذكرك» هو أن يبقى التذكر بعد الانتقال إلى جلسة أخرى. سياق الجلسة يُمسح، أما ملفات الذاكرة فلا — وهذا هو الخط الفاصل بين الاثنين.
/newينبغي أن ترى: جلسة جديدة تبدأ (كما ورد في الدرس السابق: تثبيت النموذج يبقى محفوظًا). ثم اسأله:
ما لغة البرمجة التي أفضّلها؟ينبغي أن ترى: يجيب Claw بـ TypeScript. لأن USER.md وMEMORY.md يُحقنان في السياق عند كل بداية جلسة — هذا هو «الحقن عند الإقلاع»، الطبقة الأولى من OpenClaw للذاكرة عبر الجلسات.
لاحظ تفصيلًا: يوميات اليوم والأمس memory/YYYY-MM-DD.md تُحمَّل تلقائيًا أيضًا عند تشغيل /new أو /reset المجرد. لذا فهو «يتذكر عرضًا» سياق الأمس أيضًا — هذا ليس خطأ برمجيًا، بل تصميم طبقة اليوميات (يُفصَّل في تنبيهات المطبات).
- بعد
/newلا يزال Claw قادرًا على الإجابة عن تفضيلاتك
الخطوة 3: اجعل Claw يسترجع الذكريات — البحث الدلالي عبر memory_search
لماذا: طبقة اليوميات تتراكم أكثر فأكثر، ولا يمكن حشوها كلها في السياق. memory_search يستخدم استرجاعًا هجينًا (متجهات دلالية + كلمات مفتاحية) لإيجاد الملاحظات ذات الصلة عند الحاجة — حتى لو غيّرت صياغة سؤالك، فإنه يصيب الهدف.
الطريقة A (موصى بها): اسأل عن موضوع قديم مباشرة في المحادثة. عندما لا يكون الجواب في السياق، يستدعي Claw بنفسه memory_search:
ما كان استنتاج خطة النشر التي ناقشناها الأسبوع الماضي؟ينبغي أن ترى: يعطيك Claw الاستنتاج، ويشير (عادةً) إلى يوم الملاحظة التي جاء منها. وحتى لو كانت صياغة سؤالك مختلفة تمامًا عما سُجّل حينها، فإن الاسترجاع الدلالي يطابقها.
الطريقة B: البحث مباشرة عبر CLI. openclaw memory search أثناء تشغيل Gateway يمر مباشرة عبر Gateway دون إيقاف الخدمة:
openclaw memory search "部署方案"ينبغي أن ترى: مقاطع ذاكرة ذات صلة تُعاد من الفهارس المتاحة. الصينية تعمل جيدًا بنفس القدر — المحرك المدمج يستخدم تقسيم trigram (مجموعات ثلاثية المحارف) بدعم أصلي للصينية واليابانية والكورية، وهذه قدرة مدمجة في memory-core لا تحتاج أي إعداد إضافي.
💡 يمكنك البحث حتى دون تهيئة embeddings
يستخدم الاسترجاع الدلالي افتراضيًا OpenAI embeddings، لكن استرجاع الكلمات المفتاحية (SQLite FTS5) يعمل فور التثبيت. ضبط memory.search.provider على "none" يجعله وضع كلمات مفتاحية خالصًا بلا متجهات؛ وإذا أردت توطينًا كاملًا، فهناك حل Ollama في التقنيات المتقدمة.
- سألت عن موضوع قديم، واسترجع Claw الجواب من الذاكرة
الخطوة 4: تهيئة الاستدعاء عبر الجلسات — rememberAcrossConversations
لماذا: الحقن عند الإقلاع يغطي فقط USER.md/MEMORY.md ويوميات آخر يومين. فماذا عن التفاصيل التي ناقشتها الأسبوع الماضي في محادثة خاصة أخرى؟ يتيح الاستدعاء عبر الجلسات في OpenClaw 2.0 (المُقدَّم في الإصدار v2026.8.1) للوكيل نفسه أن يستدعي السياق ذي الصلة من سجلات جلساته الخاصة الأخرى — وهذا جوهر ترقية الذاكرة في 2.0 (للخلفية راجع OpenClaw 2.0 الجديد).
التثبيتات الشخصية (حيث session.dmScope غير مضبوط أو يساوي "main"، ولا يوجد ربط يتجاوزه) مفعَّلة افتراضيًا؛ أما التثبيتات التي ضبطت عزل DM فمعطَّلة افتراضيًا. للتفعيل الصريح أو التأكيد، أضف سطرًا في openclaw.json:
{
agents: {
entries: {
personal: {
memory: {
search: {
rememberAcrossConversations: true,
},
},
},
},
},
}ينبغي أن ترى: بعد حفظ الإعداد، سيُفهرس OpenClaw سجلات جلسات ذلك الوكيل، ويشغّل استرجاعًا عبر Active Memory قبل الردود المؤهلة في المحادثات الخاصة — الخطة التي ناقشتها في المحادثة الخاصة A، إذا سألت عنها في المحادثة الخاصة B، سيتذكرها.
حدود الخصوصية مثبَّتة في الشيفرة، احفظ ثلاث نقاط:
- فقط محادثات الوكيل نفسه الخاصة يمكنها الاستدعاء المتبادل؛ المجموعات والقنوات لا تُستخدم كمصدر استدعاء ولا كوجهة له
- جلسات الوكلاء الآخرين لا تشارك أبدًا
- سجلات الجلسات المجهولة/المؤرشفة ذات البيانات الوصفية غير الكافية تُرفض
⚠️ الاستدعاء عبر الجلسات يسير في المسار المكلف
هذا الاستدعاء ينفّذه وكيل Active Memory الفرعي، ولا يُستدعى إلا «عندما يسأل رسالة عن الماضي ولا يوجد تطابق قوي في المسار الرخيص» (وضع escalate الافتراضي). الدردشة العادية لا تدفع تأخيرًا إضافيًا مقابله، لكن جولة الاسترجاع العميق تكون أبطأ قليلًا — وهذه مقايضة مقصودة في التصميم.
- تأكدت أن تثبيتك ينتمي إلى الفئة المفعَّلة افتراضيًا، أو أنك ضبطت هذا الحقل صراحةً
الخطوة 5: اتركها لـ dreaming——OpenClaw التوطيد التلقائي للذاكرة
لماذا: طبقة اليوميات تتضخم باستمرار، والاعتماد على النقل اليدوي للإدخالات المفيدة إلى MEMORY.md غير واقعي. dreaming هو نظام توطيد خلفي مفعّل افتراضيًا: يعمل كل يوم في الساعة 3 فجرًا (cron 0 3 * * *) عبر ثلاث مراحل — light (ترتيب المواد قصيرة المدى) → REM (تأمل واستخلاص المواضيع) → deep (ترقية الإدخالات المؤهلة إلى MEMORY.md). مرحلة deep وحدها هي التي تكتب MEMORY.md.
استخدم أمر المحادثة لعرض الحالة:
/dreaming statusينبغي أن ترى: الإيصال يعرض حالة dreaming الحالية. يمكن /dreaming on و /dreaming off تشغيله وإيقافه (يتطلب صلاحية owner أو admin). هذه المهمة المجدولة يديرها memory-core تلقائيًا، واسمها ثابت هو Memory Dreaming Promotion، ولا تحتاج إلى إنشاء cron يدويًا——وللتأكد من وجودها، شغّل openclaw automations list --all.
تقارير القراءة البشرية تُكتب في DREAMS.md (تحتوي صفحة Memory في Control UI على قارئ Dream Diary). لتشغيل معاينة ترقية يدويًا مرة واحدة:
openclaw memory promoteينبغي أن ترى: قائمة مرشحين مستخرجة من memory/YYYY-MM-DD.md (العتبات الافتراضية: الدرجة المرجحة ≥ 0.75، عدد مرات الاستدعاء ≥ 3، تنوع الاستعلامات ≥ 3). هذه مجرد معاينة؛ إضافة --apply فقط هي التي ستُلحق الإدخالات المختارة بـ MEMORY.md. لاحظ أن هذا الأمر يتطلب إيقاف Gateway أولًا (السبب موضح في تنبيهات المخاطر).
💡 ما الذي يمكن ترقيته؟ فقط ما تقوله أنت
عتبة الترقية ليست مجرد درجات: المرشحون ذوو المصدر untrusted و system يُستبعدون هيكليًا قبل دخول الترتيب. ما يُرى على الويب أو يقوله أعضاء المجموعة لا يدخل الذاكرة طويلة المدى مهما ارتفع تكرار استدعائه.
/dreaming statusيعرض أن dreaming مفعّل
الخطوة 6: انقل ذاكرة مساعدك القديم——Import Memory
لماذا: المستخدمون القادمون من Claude Code أو Codex أو Hermes لا يحتاجون إلى إعادة بناء ذاكراتهم القديمة. يدعم Control UI استيرادًا بنقرة واحدة لذاكرة Markdown المحلية.
مسار العملية: Control UI Settings → Import Memory، اختر الوكيل الهدف، عاين الملفات المكتشفة، وأكّد الاستيراد. الوكيل الافتراضي لديه أيضًا مدخل أخف: Settings → Ask OpenClaw وقل import memory.
الملفات التي تُقرأ من كل مصدر (يُنسخ Markdown فقط، ولا تُلمس الملفات المصدرية):
| المصدر | المحتوى المستورد |
|---|---|
| Claude Code | Markdown الخاص بـ auto-memory لكل مشروع تحت ~/.claude/projects/*/memory (بما في ذلك autoMemoryDirectory الذي قمت بتكوينه) |
| Codex | ~/.codex/memories المُدمَج تحته MEMORY.md و memory_summary.md |
| Hermes | MEMORY.md و USER.md المكتشفان في الدليل الرئيسي لـ Hermes |
ينبغي أن ترى: الملفات المستوردة مصنفة في memory/imports/claude-code/ و memory/imports/codex/ و memory/imports/hermes/ ضمن مساحة عمل الوكيل الهدف، وتُفهرس فورًا بواسطة memory_search ويمكن قراءتها عبر memory_get. لاحظ أنهالن تُدمج في MEMORY.md المحقون عند الإقلاع——الذاكرة القديمة تبقى كمواد قابلة للاسترجاع، بينما تظل ذاكرة Claw طويلة المدى تُصان من قِبله هو نفسه (ومن dreaming).
- بعد اكتمال الاستيراد، ظهرت أدلة فرعية للمصادر تحت
memory/imports/
نقاط تحقق ✅
- بعد قول «تذكّر: ...»، رأيت الإدخال الجديد في الملفات الموجودة تحت
~/.openclaw/workspace - بعد بدء جلسة جديدة عبر
/new، ما زال Claw يجيب عن تفضيلاتك - سألت عن موضوع قديم، واستعاد Claw الإجابة عبر استرجاع الذاكرة (البحث بالصينية يعمل أيضًا)
- تعرف ما إذا كان الاستدعاء عبر الجلسات في تثبيتك مفعّلًا افتراضيًا أم يحتاج إلى تهيئة صريحة
- شاهدت الحالة مرة واحدة عبر
/dreaming status، وتستطيع ذكر أي مرحلة من المراحل الثلاث تكتبMEMORY.md
تنبيهات المخاطر
❌ «كيف يتذكر أحداث الأمس حتى بعد /new؟»
السبب: /new يمسح سياق الجلسة لا الذاكرة. USER.md/MEMORY.md المحقونان عند الإقلاع يُحمّلان في بداية كل جلسة؛ ويوميات اليوم والأمس تُحمّل تلقائيًا أيضًا عند /new أو /reset المجردَين. الطبقات الثلاث كلٌّ منها مسؤول عن نفسه: سياق الجلسة (يُمسح)، طبقة اليوميات (يومان أخيران يُحمّلان تلقائيًا)، الذاكرة طويلة المدى (موجودة دائمًا).
التصرف الصحيح: لجعله «ينسى» ذكرى معينة، قل له ذلك مباشرة، أو افتح الملف واحذف ذلك السطر (Markdown يمكنك تعديله بحرية)؛ وللحذف الجماعي مع تتبع الجلسات، استخدم openclaw memory forget (موجود في تقنيات متقدمة). وإذا أردت جلسة نظيفة حقًا، لا تتوقع أن /new يمسح الذاكرة——هذا ليس عمله.
❌ مع تشغيل Gateway، تُرفض openclaw memory status / index / promote
السبب: باستثناء search و session-backfill العادي اللذين يُوجَّهان عبر Gateway قيد التشغيل، تتطلب أوامر memory الفرعية الأخرى وصولًا حصريًا إلى مخزن الذاكرة——فعندما يمتلك Gateway دليل الحالة، تُرفض هذه الأوامر مباشرة قبل فتح المخزن.
التصرف الصحيح:
openclaw gateway stop &&
openclaw memory status &&
openclaw gateway start❌ MEMORY.md يكبر أكثر فأكثر، وClaw يبدأ في «نسيان» الإدخالات المبكرة
السبب: عندما يتجاوز MEMORY.md ميزانية الحقن عند الإقلاع، يبقى الملف على القرص كما هو، لكنالنسخة المحقونة في السياق تُقتطع——الملف موجود، لكن Claw «لا يرى» النصف الثاني.
التصرف الصحيح: استخدم /context list أو /context detail أو openclaw doctor لرؤية الحجم الأصلي مقابل حجم الحقن وحالة الاقتطاع؛ انقل التفاصيل إلى طبقة يوميات memory/*.md، وأبقِ في MEMORY.md ملخصات دائمة فقط؛ وإذا كانت الميزانية غير كافية فعلًا، فكّر حينها في زيادة حد الإقلاع (مقابل ميزانية الـ prompt).
❌ توقُّع أن يتذكر Claw محتوى الويب ورسائل المجموعات كذاكرة طويلة المدى
السبب: تصنيف المصدر يعترض عند الكتابة——الذكريات المشتقة من الويب ومخرجات الأدوات والمحتوى الخارجي من المجموعات تُوسم untrusted، وتعليمات وقت التشغيل تُوسم system، وهذان النوعان من المرشحين يُستبعدان هيكليًا قبل توطيد dreaming، «فمهما ارتفع تكرار الاستدعاء لا يُرقَّيان إلى الذاكرة الأساسية». كذلك cron والنبض وجلسات الوكلاء الفرعيين لا تنتج مرشحين للذاكرة الدائمة.
التصرف الصحيح: الحقائق المهمة قلها بنفسك في محادثة خاصة (مصدر owner)؛ وما تراه في المجموعات ويستحق التذكر، انقله إليه بصياغتك. هذا تصميم أمني، ويساعدك أيضًا على تصفية الضوضاء.
تقنيات متقدمة (اختيارية)
تغيير مزوّد embeddings، أو التوطين الكامل. يستخدم الاسترجاع الدلالي افتراضيًا OpenAI embeddings؛ ويمكن عبر memory.search.provider التبديل إلى gemini أو voyage أو mistral أو bedrock أو deepinfra أو ollama أو lmstudio أو github-copilot أو openai-compatible وغيرها. لا تريد استخدام أي مفتاح API: ثبّت مزوّد llama.cpp الرسمي (openclaw plugins install @openclaw/llama-cpp-provider) ثم اضبط provider: "local"، أو استخدم مباشرة embeddings المحلية من Ollama. تذكير لمستخدمي الصينية: جودة الاسترجاع الدلالي تعتمد على نموذج embedding، بينما الاسترجاع بالكلمات المفتاحية (trigram) متاح دائمًا.
ضبط وزن الاستدعاء لذكرة معينة يدويًا بشكل دقيق. تدعم مدخلات الذاكرة تعليقات في نهاية السطر، تُكتب مع عبارة التفعيل ودرجة الأهمية (1–10):
- Keep the gateway on loopback. @@I18N_KEEP_000038@@ @@I18N_KEEP_000039@@المدخلات التي تُصيب فيها عبارة التفعيل (بدرجة ≥ 0.65) تُحقن تلقائيًا كسياق مخفي (يقتصر ذلك على المدخلات الموجودة في MEMORY.md / USER.md، وطبقة اليوميات لا تشارك)، بحد أقصى 3 مدخلات لكل دور؛ وتشارك درجة الأهمية في ترتيب الاسترجاع. المدخلات التي لا تُكتب لها تعليقات تبقى محايدة ولا تتضرر.
حذف الذاكرات حسب الجلسة. openclaw memory forget يقوم بحذف قابل للتتبع — عاين أولًا ثم نفّذ:
openclaw memory forget --agent <agent-id> --session <id-or-key> --dry-run --jsonبعد التأكد من التقرير احذف --dry-run لتنفيذ الحذف الفعلي (حذف فوري، دون تأكيد ثانٍ، مع الاحتفاظ بسجلات الجلسة المصدرية). إذا أردت فقط إعادة بناء الفهرس دون حذف الملفات: openclaw memory reset ثم openclaw memory index.
تبديل محرك الذاكرة. إلى جانب memory-core المدمج (SQLite، الافتراضي) توجد إضافات اختيارية: Honcho (ذاكرة أصلية للذكاء الاصطناعي عبر الجلسات، مع نمذجة للمستخدم)، وLanceDB (خلفية قاعدة بيانات متجهية، تدعم Ollama embeddings محليًا)؛ كما يمكن لإضافة memory-wiki إضافة طبقة قاعدة معرفية مع سلسلة أدلة بجانبها. للاستخدام الشخصي اليومي، المحرك الافتراضي كافٍ.
إنقاذ تلقائي قبل الضغط. قبل أن يُضغط سياق الجلسة (compaction)، يقوم OpenClaw أولًا بجولة صامتة من تدفق الذاكرة، يذكّر Claw بتخزين السياقات المهمة في ملفات الذاكرة — مفعّل افتراضيًا (agents.defaults.compaction.memoryFlush.enabled). لذا إذا ضُغطت جلسة طويلة في منتصفها، تكون الحقائق الأساسية عادة قد كُتبت بالفعل في طبقة اليوميات.
خلاصة هذا الدرس
✅ OpenClaw لا حالة مخفية في الذاكرة: كلها ملفات Markdown تحت ~/.openclaw/workspace + فهرس SQLite، إذا أردته أن يتذكر فقل ذلك صراحةً، وإذا أردت التحقق فافتح الملفات.
✅ أربعة ملفات بطبقات: USER.md (ملف تعريف المستخدم، مدخلات بصيغة أوامر)، MEMORY.md (الحقائق والقرارات طويلة الأمد)، memory/YYYY-MM-DD.md (طبقة اليوميات، يُحمَّل اليوم والأمس تلقائيًا)، DREAMS.md (تقرير الأحلام، لا يُحقن أبدًا).
✅ ضمانتان للذاكرة عبر الجلسات: الحقن عند الإقلاع (تحميل USER.md/MEMORY.md في كل جلسة) + memory_search الاسترجاع الدلالي (دعم أصلي لـ trigram الصينية).
✅ 2.0 الاستدعاء عبر الجلسات: المحادثات الخاصة لنفس الـ agent تستدعي بعضها البعض (مفعّل افتراضيًا في التثبيت الشخصي)، ومحادثات المجموعات والـ agents الأخرى لا تشارك أبدًا.
✅ dreaming مفعّل افتراضيًا: كل يوم عند الساعة 3 فجرًا، تعزيز ثلاثي الطور (light → REM → deep)، وطور deep وحده يكتب في MEMORY.md؛ وuntrusted/system يُستبعدان بنيويًا بحسب المصدر.
✅ يمكن ترحيل الذكريات القديمة: Settings → Import Memory للاستيراد من Claude Code / Codex / Hermes، وتقع في memory/imports/، قابلة للاسترجاع وغير مدمجة.
| حقل الإعداد | القيمة الموصى بها | الوصف |
|---|---|---|
agents.entries.<id>.memory.search.rememberAcrossConversations | true (مفعّل افتراضيًا في التثبيت الشخصي) | استدعاء عبر الجلسات بين المحادثات الخاصة لنفس الـ agent |
plugins.entries.memory-core.config.dreaming.enabled | true (افتراضي) | مفتاح التعزيز التلقائي في الخلفية |
plugins.entries.memory-core.config.dreaming.frequency | 0 3 * * * (افتراضي) | تكرار فحص dreaming، يدير memory-core الـ cron تلقائيًا |
memory.search.provider | openai (افتراضي) / ollama / none | مصدر الـ embeddings للاسترجاع الدلالي |
agents.defaults.compaction.memoryFlush.enabled | true (افتراضي) | تدفق السياقات المهمة تلقائيًا إلى ملفات الذاكرة قبل الضغط |
مرجع سريع لـ CLI: openclaw memory status (للاستعلام عن حالة الفهرس، يتطلب إيقاف Gateway)، openclaw memory search "query" (يمكن تشغيله أثناء عمل Gateway)، openclaw memory promote (لمعاينة مرشحات الترقية)، openclaw memory forget (حذف قابل للتتبع، ابدأ بـ --dry-run). جدول الأوامر الكامل في مرجع سريع لأوامر وإعدادات CLI.
استعراض الدرس التالي
الذاكرة تحل مشكلة «أن يتذكر»؛ والدرس التالي سير عمل فعال: الأتمتة والمتصفح وMCP يحل مشكلة «أن يعمل تلقائيًا» — حيث يقوم Claw بالمهام وفق الجدول دون أن تطلب منه ذلك.
ستتعلم:
- المهام المجدولة Automations: cron والتنبيهات والتشغيل عبر Webhook (تحويل «ذكّرني يوم الجمعة» إلى مهمة مجدولة حقيقية)
- أتمتة المتصفح: دع Claw يتصفح الويب وينفذ الإجراءات نيابةً عنك
- MCP: ربط Claw بأدوات ومصادر بيانات خارجية
- عند مواجهة أمر ما، كيف تختار الآلية الصحيحة بين المهارات والمهام المجدولة والذاكرة