---
read_when:
    - أنت تريد تقليل نمو السياق الناتج عن مخرجات الأدوات
    - أنت تريد فهم تحسين التخزين المؤقت للمطالبة في Anthropic
summary: اقتطاع نتائج الأدوات القديمة للحفاظ على خفة السياق وكفاءة التخزين المؤقت
title: تشذيب الجلسة
x-i18n:
    generated_at: "2026-04-26T11:27:54Z"
    model: gpt-5.4
    provider: openai
    source_hash: 3ea07f0ae23076906e2ff0246ac75813572f98cffa50afddb6a6b0af8964c4a9
    source_path: concepts/session-pruning.md
    workflow: 15
---

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

<Info>
يكون التشذيب داخل الذاكرة فقط -- فهو لا يعدّل نسخة الجلسة المخزنة على القرص.
ويتم دائمًا الاحتفاظ بسجلك الكامل.
</Info>

## لماذا يهم

تتراكم مخرجات الأدوات في الجلسات الطويلة، ما يؤدي إلى تضخيم نافذة السياق. وهذا
يزيد التكلفة وقد يفرض [Compaction](/ar/concepts/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. ولتفعيله:

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

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

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

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

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

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

- [Compaction](/ar/concepts/compaction) -- تقليل السياق المعتمد على التلخيص
- [إعداد Gateway](/ar/gateway/configuration) -- جميع عناصر تحكم إعداد التشذيب
  (`contextPruning.*`)

## ذو صلة

- [إدارة الجلسات](/ar/concepts/session)
- [أدوات الجلسة](/ar/concepts/session-tool)
- [محرك السياق](/ar/concepts/context-engine)