تشذيب الجلسة

يشذّب تشذيب الجلسة نتائج الأدوات القديمة من السياق قبل كل استدعاء لـ LLM. وهو يقلل تضخم السياق الناتج عن تراكم مخرجات الأدوات (نتائج exec، وقراءات الملفات، ونتائج البحث) من دون إعادة كتابة نص المحادثة العادي.

# لماذا يهم

تتراكم مخرجات الأدوات في الجلسات الطويلة، ما يؤدي إلى تضخيم نافذة السياق. وهذا يزيد التكلفة وقد يفرض Compaction في وقت أبكر من اللازم.

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

# كيف يعمل

1. انتظر حتى تنتهي مدة TTL الخاصة بالتخزين المؤقت (الافتراضي 5 دقائق).
2. اعثر على نتائج الأدوات القديمة من أجل التشذيب العادي (ويُترك نص المحادثة كما هو).
3. اقتطاع مرن للنتائج كبيرة الحجم -- احتفِظ بالبداية والنهاية، وأدرج ....
4. مسح صارم للباقي -- استبدله بعنصر نائب.
5. أعد تعيين TTL حتى تعيد الطلبات اللاحقة استخدام التخزين المؤقت الجديد.

# تنظيف الصور القديمة

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

• يحتفظ بآخر 3 أدوار مكتملة الأحدث كما هي بايتًا ببايت حتى تظل بادئات التخزين المؤقت للمطالبة في المتابعات الحديثة مستقرة.
• في عرض إعادة التشغيل، يمكن استبدال كتل الصور الأقدم التي تمت معالجتها بالفعل من سجل user أو toolResult بالنص [image data removed - already processed by model].
• يمكن استبدال مراجع الوسائط النصية الأقدم مثل [media attached: ...]، و[Image: source: ...]، وmedia://inbound/... بالنص [media reference removed - already processed by model]. وتبقى علامات المرفقات الخاصة بالدور الحالي كما هي حتى تظل نماذج الرؤية قادرة على ترطيب الصور الجديدة.
• لا تتم إعادة كتابة نسخة الجلسة الخام، لذلك يمكن لواجهات عرض السجل الاستمرار في عرض إدخالات الرسائل الأصلية وصورها.
• وهذا منفصل عن التشذيب العادي الخاص بـ cache TTL. وهو موجود لمنع حمولات الصور المتكررة أو مراجع الوسائط القديمة من إفساد التخزين المؤقت للمطالبات في الأدوار اللاحقة.

# الإعدادات الذكية الافتراضية

يفعّل OpenClaw التشذيب تلقائيًا لملفات تعريف Anthropic:

نوع ملف التعريف	التشذيب مفعّل	Heartbeat
مصادقة Anthropic عبر OAuth/token (بما في ذلك إعادة استخدام Claude CLI)	نعم	ساعة واحدة
API key	نعم	30 دقيقة

إذا قمت بتعيين قيم صريحة، فلن يتجاوزها OpenClaw.

# التفعيل أو التعطيل

يكون التشذيب معطلًا افتراضيًا للموفرين غير التابعين لـ Anthropic. ولتفعيله:

{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}

ولتعطيله: عيّن mode: "off".

# التشذيب مقابل Compaction

	التشذيب	Compaction
ما هو	يقتطع نتائج الأدوات	يلخص المحادثة
يُحفظ؟	لا (لكل طلب)	نعم (في نسخة الجلسة)
النطاق	نتائج الأدوات فقط	المحادثة بأكملها

يكمل كلٌّ منهما الآخر -- إذ يحافظ التشذيب على خفة مخرجات الأدوات بين دورات Compaction.

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

• Compaction -- تقليل السياق المعتمد على التلخيص
• إعداد Gateway -- جميع عناصر تحكم إعداد التشذيب (contextPruning.*)

# ذو صلة

• إدارة الجلسات
• أدوات الجلسة
• محرك السياق