Oturum budama

Oturum budama, her LLM çağrısından önce eski araç sonuçlarını bağlamdan kırpar. Normal konuşma metnini yeniden yazmadan birikmiş araç çıktılarının (yürütme sonuçları, dosya okumaları, arama sonuçları) yol açtığı bağlam şişmesini azaltır.

Neden önemlidir?

Uzun oturumlarda biriken araç çıktıları bağlam penceresini şişirir. Bu, maliyeti artırır ve Compaction işlemini gerekenden daha erken zorunlu kılabilir.

Budama, özellikle Anthropic istem önbelleğe alma için değerlidir. Önbellek TTL süresi dolduktan sonra bir sonraki istek, istemin tamamını yeniden önbelleğe alır. Budama, önbelleğe yazma boyutunu azaltarak maliyeti doğrudan düşürür.

Nasıl çalışır?

Budama, hem zaman hem de bağlam boyutu denetimine bağlı olarak cache-ttl modunda çalışır:

1. Önbellek TTL süresinin dolmasını bekleyin (elle ayarlandığında varsayılan 5 dakikadır; Anthropic otomatik varsayılanı için Akıllı varsayılanlar bölümüne bakın). TTL dolmadan önce, yakın zamanlı dönüşlerde istem önbelleğinin yeniden kullanılmasını korumak için budama tamamen atlanır.
2. TTL dolduktan sonra toplam bağlam boyutunu modelin bağlam penceresine göre tahmin edin. Oran softTrimRatio değerinin (varsayılan 0.3) altındaysa budamayı atlayın ve TTL saatini çalışır durumda tutun.
3. Oranın üzerindeki büyük boyutlu araç sonuçlarını yumuşak kırpın: başlangıcı ve sonu koruyun (varsayılan olarak her biri 1500 karakter, toplamda en fazla 4000 karakter) ve araya ... ekleyin.
4. Oran hâlâ hardClearRatio değerinde veya üzerindeyse (varsayılan 0.5) ve budanabilir araç içeriğinden en az minPrunableToolChars (varsayılan 50.000) kaldıysa bu sonuçları tamamen temizleyin: içeriklerini bir yer tutucuyla değiştirin (varsayılan [Old tool result content cleared]).
5. TTL saatini yalnızca budama bağlamı gerçekten değiştirdiğinde sıfırlayın; böylece sonraki istekler yeni önbelleği yeniden kullanır.

Eşiklerden bağımsız olarak iki güvenlik kuralı uygulanır: en son keepLastAssistants asistan dönüşü (varsayılan 3) hiçbir zaman budanmaz ve oturumun ilk kullanıcı mesajından önceki hiçbir şey budanmaz (SOUL.md/USER.md gibi önyükleme okumalarını korur).

Yalnızca toolResult mesajları uygundur; normal konuşma metnine dokunulmaz. Hangi araç adlarının budanabilir olduğunu sınırlamak için agents.defaults.contextPruning.tools.{allow,deny} kullanın.

Eski görüntüleri temizleme

OpenClaw ayrıca geçmişte ham görüntü bloklarını veya istem hazırlama medya işaretçilerini kalıcı olarak tutan oturumlar için ayrı, birden çok kez güvenle uygulanabilen bir yeniden oynatma görünümü oluşturur.

• Yakın zamanlı takip isteklerine ait istem önbelleği öneklerinin kararlı kalması için tamamlanan en son 3 dönüşü bayt bayt korur. Bu sayı yalnızca görüntü içerenleri değil, tamamlanan tüm dönüşleri kapsar; bu nedenle yalnızca metin içeren dönüşler de pencereyi tüketir.
• Yeniden oynatma görünümünde, user veya toolResult geçmişindeki daha eski ve önceden işlenmiş görüntü blokları [image data removed - already processed by model] ile değiştirilir.
• [media attached: ...], [Image: source: ...] ve media://inbound/... gibi daha eski metinsel medya başvuruları [media reference removed - already processed by model] ile değiştirilir. Mevcut dönüşün ek işaretçileri olduğu gibi kalır; böylece görsel modeller yeni görüntüleri hazırlamaya devam edebilir.
• Ham oturum dökümü yeniden yazılmaz; böylece geçmiş görüntüleyicileri özgün mesaj girdilerini ve görüntülerini göstermeye devam edebilir.
• Bu, yukarıdaki normal önbellek TTL budamasından ayrıdır. Yinelenen görüntü yüklerinin veya eski medya başvurularının sonraki dönüşlerde istem önbelleklerini bozmasını önlemek için kullanılır.

Akıllı varsayılanlar

Paketle birlikte gelen Anthropic Plugin, bir Anthropic (veya Claude CLI) kimlik doğrulama profilini ilk kez çözümlerken budama ve Heartbeat sıklığını otomatik olarak yapılandırır; ancak bunu yalnızca daha önce açıkça ayarlamadığınız alanlar için yapar:

agents.defaults.contextPruning.mode veya agents.defaults.heartbeat.every değerini kendiniz ayarlarsanız OpenClaw bunları geçersiz kılmaz. Bu otomatik varsayılan yalnızca Anthropic ailesi kimlik doğrulaması için devreye girer; yapılandırmadığınız sürece diğer sağlayıcılarda budama off olur.

Etkinleştirme veya devre dışı bırakma

Budama, Anthropic dışındaki sağlayıcılarda varsayılan olarak kapalıdır. Etkinleştirmek için:

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

Devre dışı bırakmak için mode: "off" değerini ayarlayın.

Budama ve Compaction karşılaştırması

Birbirlerini tamamlarlar; budama, Compaction döngüleri arasında araç çıktısını sade tutar.

Ek okumalar

• Compaction: özetlemeye dayalı bağlam azaltma
• Gateway Yapılandırması: tüm budama yapılandırma seçenekleri (contextPruning.*)

İlgili konular

• Oturum yönetimi
• Oturum araçları
• Bağlam motoru