الانتقال إلى المحتوى الرئيسي

​
تشذيب الجلسة

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

​
لماذا يهم

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

​
كيف يعمل

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

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

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

​
القيم الافتراضية الذكية

يفعّل OpenClaw التشذيب تلقائيًا لملفات تعريف Anthropic:
نوع ملف التعريفالتشذيب مفعّلHeartbeat
مصادقة Anthropic عبر OAuth/الرمز (بما في ذلك إعادة استخدام Claude CLI)نعمساعة واحدة
مفتاح APIنعم30 دقيقة
إذا ضبطت قيمًا صريحة، فلن يقوم OpenClaw بتجاوزها.

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

يكون التشذيب معطّلًا افتراضيًا للموفّرين غير Anthropic. ولتفعيله: 
{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}
ولتعطيله: اضبط mode: "off".

​
التشذيب مقابل الضغط

التشذيبالضغط
ما الذي يفعلهيقلّم نتائج الأدواتيلخّص المحادثة
هل يُحفظ؟لا (لكل طلب)نعم (في النص)
النطاقنتائج الأدوات فقطالمحادثة بالكامل
يكمل كل منهما الآخر — فالتشذيب يبقي مخرجات الأدوات خفيفة بين دورات الضغط.

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

  • الضغط — تقليل السياق المعتمد على التلخيص
  • إعداد البوابة — جميع عناصر تحكم إعداد التشذيب (contextPruning.*)