openclaw memory
عرض وإدارة ذاكرة الجلسات، بما في ذلك استخدام الرموز (tokens) وملفات السياق.
الاستخدام الأساسي
openclaw memory [command] [options]
الأوامر
عرض استخدام الذاكرة
# عرض استخدام الذاكرة لجميع الجلسات openclaw memory # عرض جلسة محددة openclaw memory --session agent:main # عرض بتنسيق JSON openclaw memory --json
تحليل استخدام الرموز
# عرض إحصائيات الرموز التفصيلية openclaw memory stats # حسب الجلسة openclaw memory stats --session agent:main # حسب الفترة الزمنية openclaw memory stats --since 24h openclaw memory stats --since 7d
فحص ملفات السياق
# عرض ملفات السياق المحملة openclaw memory context # لجلسة محددة openclaw memory context --session agent:main # عرض محتوى ملف سياق معين openclaw memory context --file AGENTS.md
إدارة الضغط (Compaction)
# فرض ضغط الذاكرة لجلسة openclaw memory compact --session agent:main # ضغط جميع الجلسات openclaw memory compact --all # معاينة بدون تنفيذ openclaw memory compact --dry-run
مسح الذاكرة
# مسح ذاكرة جلسة محددة openclaw memory clear --session agent:main # حذف الجلسات القديمة openclaw memory clean --days 30 # حذف الجلسات غير النشطة openclaw memory clean --inactive
الخيارات
| الخيار | الوصف |
|---|---|
| --session <id> | معرف الجلسة المحددة |
| --json | إخراج بتنسيق JSON |
| --since <duration> | تصفية حسب الفترة الزمنية (مثل: 24h, 7d, 30d) |
| --file <name> | اسم ملف السياق |
| --all | تطبيق على جميع الجلسات |
| --dry-run | معاينة بدون تنفيذ |
| --days <number> | عدد الأيام للاحتفاظ |
| --inactive | الجلسات غير النشطة فقط |
| --verbose | عرض معلومات تفصيلية |
مكونات الذاكرة
سياق الجلسة (Session Context)
تاريخ المحادثة، الرسائل المتبادلة، وحالة الجلسة الحالية.
ملفات السياق (Context Files)
الملفات المحملة من workspace مثل AGENTS.md, USER.md, MEMORY.md.
استخدام الرموز (Token Usage)
عدد الرموز المستخدمة للإدخال والإخراج وإجمالي التكلفة.
الذاكرة المضغوطة (Compacted Memory)
ملخصات تلقائية للمحادثات القديمة لتوفير الرموز.
أمثلة متقدمة
مراقبة استهلاك الرموز
# إجمالي الاستخدام اليوم openclaw memory stats --since 24h # أكثر الجلسات استهلاكاً openclaw memory stats --json | jq 'sort_by(.tokens) | reverse | .[0:5]' # تكلفة الاستخدام بالدولار openclaw memory stats --cost
تحسين استخدام الذاكرة
# ضغط الجلسات الكبيرة
openclaw memory --json | jq '.[] | select(.tokens > 50000)' \
| jq -r '.sessionId' \
| xargs -I {} openclaw memory compact --session {}
# تنظيف الجلسات القديمة (أكثر من شهر)
openclaw memory clean --days 30 --verboseفحص ملفات السياق المحملة
# عرض جميع ملفات السياق
openclaw memory context --verbose
# حساب الرموز لكل ملف
openclaw memory context --json | jq '.[] | {file: .name, tokens: .tokens}'
# العثور على الملفات الكبيرة
openclaw memory context --json | jq '.[] | select(.tokens > 10000)'💡 نصائح لتحسين الذاكرة
- راقب استخدام الرموز بانتظام لتجنب التكاليف غير المتوقعة
- استخدم الضغط التلقائي للجلسات الطويلة
- قم بتنظيف الجلسات القديمة شهرياً
- حافظ على ملفات السياق صغيرة ومركزة
- استخدم
--dry-runقبل الحذف
فهم الضغط (Compaction)
الضغط هو عملية تلقائية تلخص المحادثات القديمة للحفاظ على الذاكرة قصيرة:
- 📝التلخيص التلقائي: يتم تلخيص الرسائل القديمة تلقائياً عندما تصل الجلسة إلى حد معين
- 💾الحفاظ على السياق: يتم الاحتفاظ بالمعلومات المهمة أثناء التلخيص
- ⚡تحسين الأداء: تقليل عدد الرموز يحسن سرعة الاستجابة ويقلل التكلفة
- 🔄شفاف: يحدث في الخلفية بدون تدخل المستخدم
حدود الذاكرة
| النموذج | حد السياق | نقطة الضغط |
|---|---|---|
| Claude 3.5 Sonnet | 200,000 رمز | ~150,000 رمز |
| GPT-4 | 128,000 رمز | ~100,000 رمز |
| GPT-3.5 | 16,000 رمز | ~12,000 رمز |
استكشاف الأخطاء
الجلسة تستخدم الكثير من الرموز
# فحص استخدام الجلسة openclaw memory --session agent:main --verbose # فرض الضغط openclaw memory compact --session agent:main # فحص ملفات السياق openclaw memory context --session agent:main
أخطاء "Context Length Exceeded"
# ضغط فوري openclaw memory compact --session agent:main # أو مسح الجلسة وإعادة البدء openclaw sessions end agent:main openclaw agent start
الأوامر ذات الصلة
openclaw sessions- إدارة الجلساتopenclaw models- معلومات النماذج وحدود الرموزopenclaw config- تكوين إعدادات الذاكرة
📚 اقرأ المزيد
لمعلومات تفصيلية عن كيفية عمل الذاكرة في OpenClaw، راجع دليل الذاكرة المفاهيمي.