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

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

يقوم تشذيب الجلسات بتقليم نتائج الأدوات القديمة من السياق الموجود في الذاكرة مباشرة قبل كل استدعاء لـ LLM. وهو لا يعيد كتابة سجل الجلسة المحفوظ على القرص (*.jsonl).

​
متى يعمل

  • عندما يكون mode: "cache-ttl" مفعّلًا وكان آخر استدعاء لـ Anthropic للجلسة أقدم من ttl.
  • يؤثّر فقط على الرسائل المُرسلة إلى النموذج لذلك الطلب.
  • نشِط فقط لاستدعاءات واجهة Anthropic البرمجية (ونماذج Anthropic عبر OpenRouter).
  • للحصول على أفضل النتائج، طابِق ttl مع cacheControlTtl الخاص بنموذجك.
  • بعد تنفيذ التشذيب، تُعاد تهيئة نافذة TTL بحيث تحتفظ الطلبات اللاحقة بالتخزين المؤقت إلى أن تنتهي صلاحية ttl مرة أخرى.

​
الإعدادات الافتراضية الذكية (Anthropic)

  • ملفات OAuth أو setup-token: تفعيل تشذيب cache-ttl وضبط نبض القلب على 1h.
  • ملفات API key: تفعيل تشذيب cache-ttl، ضبط نبض القلب على 30m، وتعيين cacheControlTtl افتراضيًا إلى 1h على نماذج Anthropic.
  • إذا قمت بتعيين أي من هذه القيم صراحةً، فلن يقوم OpenClaw بتجاوزها.

​
ما الذي يُحسِّنه هذا (التكلفة + سلوك التخزين المؤقت)

  • لماذا التشذيب: ينطبق التخزين المؤقت لمطالبة Anthropic فقط ضمن فترة TTL. إذا ظلت الجلسة خاملة بعد TTL، فسيُعاد تخزين المطالبة كاملة في الطلب التالي ما لم تُقلِّمها أولًا.
  • ما الذي يصبح أقل تكلفة: يقلّل التشذيب حجم cacheWrite لذلك الطلب الأول بعد انتهاء TTL.
  • أهمية إعادة ضبط TTL: بمجرد تنفيذ التشذيب، تُعاد نافذة التخزين المؤقت، بحيث يمكن للطلبات اللاحقة إعادة استخدام المطالبة المُخزّنة حديثًا بدلًا من إعادة تخزين السجل الكامل مرة أخرى.
  • ما الذي لا يفعله: لا يضيف التشذيب رموزًا (tokens) ولا «يُضاعف» التكاليف؛ بل يغيّر فقط ما يتم تخزينه مؤقتًا في ذلك الطلب الأول بعد TTL.

​
ما الذي يمكن تشذيبه

  • فقط رسائل toolResult.
  • رسائل المستخدم والمساعد لا يتم تعديلها أبدًا.
  • آخر keepLastAssistants رسائل للمساعد محمية؛ ولا يتم تشذيب نتائج الأدوات بعد حدّ القطع هذا.
  • إذا لم يكن هناك عدد كافٍ من رسائل المساعد لتحديد حدّ القطع، يتم تجاوز التشذيب.
  • نتائج الأدوات التي تحتوي على كتل صور يتم تجاوزها (لا تُقلَّم/تُزال أبدًا).

​
تقدير نافذة السياق

يستخدم التشذيب تقديرًا لنافذة السياق (الأحرف ≈ الرموز × 4). ويتم حلّ النافذة الأساسية بهذا الترتيب:
  1. تجاوز models.providers.*.models[].contextWindow.
  2. تعريف النموذج contextWindow (من سجل النماذج).
  3. القيمة الافتراضية 200000 من الرموز.
إذا تم تعيين agents.defaults.contextTokens، فسيُعامل كسقف (الحد الأدنى) على النافذة المُحَلّة.

​
النمط

​
cache-ttl

  • لا يعمل التشذيب إلا إذا كان آخر استدعاء لـ Anthropic أقدم من ttl (الافتراضي 5m).
  • عند التنفيذ: نفس سلوك التقليم اللطيف + الإزالة الصارمة كما في السابق.

​
ناعمة ضد تشويش قاس

  • التقليم اللطيف: فقط لنتائج الأدوات كبيرة الحجم.
    • يحتفظ بالمقدمة + الخاتمة، ويدرِج ...، ويُلحق ملاحظة بالحجم الأصلي.
    • يتجاوز النتائج التي تحتوي على كتل صور.
  • الإزالة الصارمة: تستبدل نتيجة الأداة بالكامل بـ hardClear.placeholder.

​
اختيار الأدوات

  • يدعم tools.allow / tools.deny محارف * الشاملة.
  • إنكار الفوز.
  • المطابقة غير حسّاسة لحالة الأحرف.
  • قائمة السماح الفارغة => جميع الأدوات مسموح بها.

​
التفاعل مع حدود أخرى

  • تقوم الأدوات المدمجة أصلًا باقتطاع مخرجاتها؛ ويُعدّ تشذيب الجلسات طبقة إضافية تمنع الدردشات طويلة الأمد من تراكم قدر كبير من مخرجات الأدوات في سياق النموذج.
  • الضغط (Compaction) منفصل: الضغط يُلخِّص ويُثبّت، بينما التشذيب مؤقّت لكل طلب. انظر /concepts/compaction.

​
القيم الافتراضية (عند التفعيل)

  • ttl: "5m"
  • keepLastAssistants: 3
  • softTrimRatio: 0.3
  • hardClearRatio: 0.5
  • minPrunableToolChars: 50000
  • softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 }
  • hardClear: { enabled: true, placeholder: "[Old tool result content cleared]" }

​
أمثلة

الافتراضي (متوقف): 
{
  agent: {
    contextPruning: { mode: "off" },
  },
}
تمكين تشذيب واعٍ بـ TTL: 
{
  agent: {
    contextPruning: { mode: "cache-ttl", ttl: "5m" },
  },
}
تقييد التشذيب على أدوات محددة: 
{
  agent: {
    contextPruning: {
      mode: "cache-ttl",
      tools: { allow: ["exec", "read"], deny: ["*image*"] },
    },
  },
}
انظر مرجع التهيئة: Gateway Configuration