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

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

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

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

## لماذا يهم

تتراكم مخرجات الأدوات في الجلسات الطويلة بما يؤدي إلى تضخيم نافذة السياق. وهذا
يزيد التكلفة ويمكن أن يفرض [الضغط](/concepts/compaction) في وقت أبكر من
اللازم.

ويكون التشذيب ذا قيمة خاصة بالنسبة إلى **التخزين المؤقت للمطالبات في 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. ولتفعيله:

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

ولتعطيله: اضبط `mode: "off"`.

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

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

يكمل كل منهما الآخر -- فالتشذيب يبقي مخرجات الأدوات خفيفة بين
دورات الضغط.

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

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