Pruning della sessione
Il pruning della sessione riduce i vecchi risultati degli strumenti dal contesto prima di ogni chiamata LLM. Riduce il gonfiore del contesto dovuto agli output accumulati degli strumenti (risultati di exec, letture di file, risultati di ricerca) senza riscrivere il normale testo della conversazione.
Il pruning avviene solo in memoria — non modifica la trascrizione della sessione su disco.
La cronologia completa viene sempre conservata.
Perché è importante
Le sessioni lunghe accumulano output degli strumenti che gonfiano la finestra di contesto. Questo
aumenta il costo e può forzare la compattazione prima del
necessario.
Il pruning è particolarmente utile per il prompt caching di Anthropic. Dopo la scadenza del TTL
della cache, la richiesta successiva mette nuovamente in cache l’intero prompt. Il pruning riduce la dimensione di scrittura nella
cache, abbassando direttamente il costo.
Come funziona
- Attende la scadenza del TTL della cache (predefinito 5 minuti).
- Trova i vecchi risultati degli strumenti per il pruning normale (il testo della conversazione viene lasciato invariato).
- Riduzione soft dei risultati troppo grandi — mantiene l’inizio e la fine, inserendo
....
- Cancellazione hard del resto — sostituisce con un segnaposto.
- Reimposta il TTL così che le richieste successive riutilizzino la cache aggiornata.
Pulizia legacy delle immagini
OpenClaw esegue anche una pulizia idempotente separata per le sessioni legacy più vecchie che
mantenevano blocchi immagine grezzi nella cronologia.
- Conserva i 3 turni completati più recenti byte per byte, così i prefissi della cache dei prompt
per i follow-up recenti restano stabili.
- I blocchi immagine già elaborati più vecchi nella cronologia
user o toolResult possono essere
sostituiti con [image data removed - already processed by model].
- Questo è separato dal normale pruning del TTL della cache. Esiste per impedire che payload di immagini ripetuti invalidino le cache dei prompt nei turni successivi.
Impostazioni predefinite intelligenti
OpenClaw abilita automaticamente il pruning per i profili Anthropic:
| Tipo di profilo | Pruning abilitato | Heartbeat |
|---|
| Autenticazione Anthropic OAuth/token (incluso il riuso di Claude CLI) | Sì | 1 ora |
| Chiave API | Sì | 30 min |
Abilitare o disabilitare
Il pruning è disattivato per impostazione predefinita per i provider non Anthropic. Per abilitarlo:
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
mode: "off".
Pruning vs compattazione
| Pruning | Compattazione |
|---|
| Cosa | Riduce i risultati degli strumenti | Riassume la conversazione |
| Salvato? | No (per richiesta) | Sì (nella trascrizione) |
| Ambito | Solo risultati degli strumenti | Intera conversazione |
Ulteriori letture
