## سقف الذاكرة

إذا قمت بتشغيل OpenClaw اليوم، فسيقوم وكيلك بتخزين الذاكرة في `MEMORY.md` والملفات المؤرخة في دليل `memory/`. يعمل هذا مع وكيل واحد، واستخدام جلسة واحدة. في اللحظة التي تعتمد فيها على تلك الذاكرة في أي شيء يحدث، فإنك تصل إلى السقف. أوضاع الفشل محددة ويمكن التنبؤ بها.

**ضغط الذاكرة يسقط الحقائق.** يقوم OpenClaw بتشغيل وكيل صامت يكتب "ذكريات دائمة" قبل اقتطاع السياق. ما كان موجودًا في الملف قبل الضغط غير معروف. إذا أسقطت النسخة المضغوطة حقيقة، فقد اختفت. لا يوجد سجل المراقبة. لا التراجع.

**لا توجد هوية كيان عبر الجلسات.** قد يتم أو لا يتم حل "Acme Corp" في جلسة واحدة و"ACME CORP" في الجلسة التالية لنفس الكيان. يقوم الوكيل بإعادة الاستدلال في كل مرة من نافذة السياق. لا توجد معرفات ثابتة. لا توجد قواعد الدمج.

** المتزامن يكتب حالة فاسدة. ** إذا قمت بتشغيل العديد من الوكلاء أو المكونات الإضافية التي تلمس نفس ملفات الذاكرة، فستحصل على تلف البيانات. تقر وثائق OpenClaw الخاصة بذلك. إن سقف الوكيل الفردي حقيقي، ولن تظل معظم عمليات سير عمل الوكلاء قائمة على وكيل واحد إلى الأبد.

**لا يوجد سجل تدقيق.** عندما يقدم الوكيل إجابة خاطئة، لا يمكنك تتبعها وصولاً إلى ملاحظة محددة. لا يمكنك رؤية ما تغير بين الثلاثاء والخميس. لا يمكنك الإجابة على "ماذا عرف وكيل أعمالي عندما اتخذ هذا القرار؟"

هذه ليست حالات الحافة. تظهر بمجرد تعامل الوكيل مع جهات الاتصال أو المهام أو المعاملات أو أي حالة مهمة عبر الجلسات.

## ما يضيفه البرنامج المساعد

[Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) يضيف بيان `openclaw.plugin.json` ونقطة دخول وتعريفات الأدوات التي يتم تسجيلها في نظام المكونات الإضافية المكون من أربع طبقات لـ OpenClaw. تكتشف البوابة المكون الإضافي، وتتحقق من صحة البيان، وتحميل وقت التشغيل، وتعرض أدوات Neotoma للوكيل.

كل وضع فشل أعلاه يحصل على إصلاح هيكلي.

** لم يعد الضغط يفقد حالته. ** الملاحظات ملحقة فقط. لا يزال بإمكان الملخص المضغوط أن يخدم نافذة السياق، لكن ملاحظات المصدر تستمر في Neotoma مع التاريخ الكامل. لا شيء يتم إسقاطه بصمت.

**هوية الكيان حتمية.** تعمل المعرفات الأساسية المستندة إلى التجزئة على تحليل "Acme Corp" و"ACME CORP" لكيان واحد حسب القاعدة، وليس عن طريق الاستدلال لكل جلسة. نفس جهة الاتصال، نفس المعرف، في كل مرة.

** تعتبر عمليات الكتابة المتزامنة آمنة. ** يقوم وكيلان يكتبان حول نفس الكيان بإنتاج ملاحظتين في مخزن الإلحاق فقط، وليس تعارضًا في الملف. تتحقق قيود المخطط من صحة كل كتابة قبل دخولها إلى المتجر.

**مسار التدقيق مدمج.** كل ملاحظة تتتبع مصدرها. تؤدي التصحيحات إلى إنشاء ملاحظات جديدة، وليس إلى الكتابة الفوقية. يمكنك إعادة بناء الحالة في أي وقت.

بالإضافة إلى تثبيت السقف، يكشف البرنامج الإضافي عن إمكانات لا يمكن لـ MEMORY.md أن يدعمها على الإطلاق:

- **استرجاع منظم.** "جميع المهام المرتبطة بجهة الاتصال هذه" أو "كل معاملة مع البائع X" هو استعلام، وليس ملف grep.
- **استعلامات المخطط الزمني.** تنتج حقول التاريخ عبر الكيانات جداول زمنية. "ما حدث الأسبوع الماضي" يصل إلى فهرس زمني، وليس بحث في نافذة السياق.
- **التحقق من صحة المخطط.** يتم التحقق من أنواع الكيانات عند الكتابة. يتم رفض البيانات السيئة قبل دخولها إلى المتجر.

لا تتغير حلقة الوكيل. لا يزال OpenClaw يدير تفسير النوايا والتصفح وملء النماذج وتنفيذ المهارات. نيوتوما يتعامل مع الحالة. يقع البرنامج المساعد بين عمليات الكتابة الخاصة بالوكيل والتخزين المستمر.

## السؤال العام

ملفات تخفيض السعر مجانية. فهي لا تكلف شيئًا لإعدادها، ولا شيء للصيانة، كما أن اقتصاديات KV-cache تكافئها بشكل فعال.

يضيف نيوتوما النفقات العامة. التحقق من صحة المخطط عند الكتابة. تخزين المراقبة. قرار الكيان عملية الخادم المحلي. هذه ليست مجانية. لكن النفقات العامة مصممة لتظل غير مرئية: يقوم الوكيل بتثبيت Neotoma، وتكوينه، والكتابة إليه دون الحاجة إلى تعلم أداة جديدة أو تغيير طريقة عملك.

والسؤال هو ما إذا كانت النفقات العامة تستحق الدفع. إذا لم يكن وكيلك بحاجة أبدًا للإجابة على "ماذا عرفت يوم الثلاثاء الماضي" أو "الكتابة التي أفسدت سجل جهة الاتصال هذا"، فلا. `MEMORY.md` هي البنية الصحيحة.

إذا كان وكيلك يدير الحالة المستمرة وجهات الاتصال والمهام والمعاملات والعلاقات مع البائعين، وكنت بحاجة إلى الاتساق عبر الجلسات، فإن الحمل الزائد لمسار الكتابة هو الجزء الأرخص من المشكلة. الجزء المكلف هو تصحيح أخطاء فساد الدولة بعد حدوثها، عندما لا يكون مسار التدقيق موجودًا.

## ما لا يفعله هذا

لا يحل البرنامج المساعد محل حلقة وكيل OpenClaw. لا يغير كيفية عمل المهارات. لا يتطلب الأمر ترحيل محتوى `MEMORY.md` الموجود (على الرغم من دعم الاستيراد).

لا يحل كل مشكلة ذاكرة الوكيل. لا تزال جودة الاسترجاع والهندسة السريعة وتصميم المهارات واختيار النموذج مهمة. يتعامل Neotoma مع طبقة الحالة: ما هي الكيانات الموجودة، وكيف ترتبط، ومن أين أتت، وكيف تغيرت. كل شيء فوق تلك الطبقة يبقى كما هو.

كما أنها لا تدعي استقرار الإنتاج. نيوتوما موجود في [إصدار المطور](/posts/neotoma-developer-release). وينبغي توقع التغييرات العاجلة. تم إنشاء البرنامج الإضافي لاختبار الضغط فيما إذا كانت الحالة المنظمة ضمن منصة الوكيل الحقيقي تعمل عمليًا، وليس للوعد بالموثوقية اليوم.

## جربه، اكسره

لقد قمت بتشغيل Neotoma كطبقة ذاكرة في [مكدس الوكيل الخاص بي](/posts/what-my-agentic-stack-actually-does). يكتب العديد من الوكلاء إلى نفس المتجر: فرز البريد الإلكتروني، وإدارة المهام، والتمويل، والمحتوى. إن مشاكل حالة تعدد الوكلاء الموصوفة أعلاه ليست افتراضية بالنسبة لي. هم ما ضربته كل أسبوع.

البرنامج المساعد يجعل هذا متاحًا لمستخدمي OpenClaw. تثبيته. تمكينه. قم بتشغيل الوكيل الخاص بك مع الحالة المنظمة تحته. انظر أين يساعد. انظر أين النفقات العامة لا يستحق كل هذا العناء. انظر أين ينكسر التصميم.

إن حلقة التغذية الراجعة مهمة أكثر من الهندسة المعمارية. الوكلاء الحقيقيون الذين يكتبون ملاحظات حقيقية من خلال طبقة منظمة هو المكان الذي تثبت فيه المطالبات أو تفشل.

## تقييم وتثبيت

أسرع طريقة لمعرفة ما إذا كان Neotoma يناسب سير عمل OpenClaw الخاص بك هو السماح لوكيلك بتقييمه نيابةً عنك. الصق هذا في جلسة OpenClaw الخاصة بك:

```نسخ
اقرأ https://neotoma.io/evaluate. قبل الإجابة، قم بفحص أي أداة ومساحة عمل وسياق تكوين أوسع يمكنك الوصول إليه حتى تتمكن من تقييم سير العمل الحقيقي الخاص بي بدلاً من مجرد هذه الدردشة. ثم أخبرني ما إذا كان Neotoma مناسبًا حقًا لسير عملي، وما هي البيانات التي ستكون ذات قيمة أعلى للاستمرار أولاً، وما الذي يجب علي فعله بعد ذلك.
```

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

إذا كنت تريد Neotoma بالفعل وتفضل تخطي [خطوة التقييم](https://neotoma.io/evaluate)، فاستخدم التثبيت بمساعدة الوكيل من [neotoma.io/install](https://neotoma.io/install). الصق هذا في OpenClaw. يقرأ وكيلك تسلسل التثبيت أولاً الكامل في تلك الصفحة، ويقوم بالتثبيت فقط إذا لزم الأمر، ويقوم بتشغيل التنشيط باستخدام بياناتك، ثم يقوم بتكوين أداتك الحالية للاستخدام المستمر، بما في ذلك خطوات تكامل OpenClaw على نفس الصفحة:

```نسخ
اقرأ https://neotoma.io/install وحملني خلال تدفق Neotoma للتثبيت الأول. قم بتثبيته وتنشيطه باستخدام بياناتي وتكوين أداتي الحالية للاستخدام المستمر القوي.
```

إذا كنت تفضل الأوامر اليدوية: يضيف `openclaw plugins install clawhub:neotoma` المكون الإضافي مباشرة من ClawHub. أو قم بتثبيت حزمة npm عالميًا باستخدام npm install -g neotoma ثم `neotoma init`، مع دبوس اختياري لهذا الإصدار (`npm install -g neotoma@0.4.3`). تظل الخيارات الكاملة وتكوين MCP وDocker وسلوك إعادة التعيين على [neotoma.io/install](https://neotoma.io/install).

الريبو: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). ملاحظات الإصدار: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3).

للحصول على المنطق المعماري الأعمق وراء ذاكرة الوكيل المنظمة، راجع [OpenClaw وطبقة الحقيقة](/posts/openclaw-and-the-truth-layer) و[سقف ذاكرة تخفيض السعر](/posts/the-markdown-memory-ceiling).