Potatura della sessione

La potatura della sessione riduce i vecchi risultati degli strumenti dal contesto prima di ogni chiamata LLM. Riduce il rigonfiamento del contesto dovuto agli output accumulati degli strumenti (risultati exec, letture di file, risultati di ricerca) senza riscrivere il normale testo della conversazione.

# Perché è importante

Le sessioni lunghe accumulano output degli strumenti che gonfiano la finestra di contesto. Questo aumenta il costo e può forzare la Compaction prima del necessario.

La potatura è particolarmente preziosa per la cache dei prompt Anthropic. Dopo la scadenza del TTL della cache, la richiesta successiva rimette in cache l'intero prompt. La potatura riduce la dimensione della scrittura in cache, abbassando direttamente il costo.

# Come funziona

1. Attendi la scadenza del TTL della cache (predefinito 5 minuti).
2. Trova i vecchi risultati degli strumenti per la normale potatura (il testo della conversazione resta invariato).
3. Soft-trim dei risultati sovradimensionati -- mantieni testa e coda, inserisci ....
4. Hard-clear del resto -- sostituiscilo con un segnaposto.
5. Reimposta il TTL così che le richieste successive riutilizzino la cache aggiornata.

# Pulizia legacy delle immagini

OpenClaw costruisce anche una vista di replay separata e idempotente per le sessioni che mantengono blocchi immagine grezzi o marcatori media di idratazione del prompt nella cronologia.

• Preserva i 3 turni completati più recenti byte per byte così che i prefissi della cache dei prompt per i follow-up recenti restino stabili.
• Nella vista di replay, i vecchi blocchi immagine già elaborati dalla cronologia user o toolResult possono essere sostituiti con [image data removed - already processed by model].
• I vecchi riferimenti media testuali come [media attached: ...], [Image: source: ...] e media://inbound/... possono essere sostituiti con [media reference removed - already processed by model]. I marcatori di allegato del turno corrente restano intatti così che i modelli vision possano ancora idratare immagini nuove.
• Il transcript grezzo della sessione non viene riscritto, quindi i visualizzatori della cronologia possono ancora renderizzare le voci originali dei messaggi e le loro immagini.
• Questo è separato dalla normale potatura TTL della cache. Esiste per impedire che payload di immagini ripetuti o riferimenti media obsoleti rompano le cache dei prompt nei turni successivi.

# Predefiniti intelligenti

OpenClaw abilita automaticamente la potatura per i profili Anthropic:

Tipo di profilo	Potatura abilitata	Heartbeat
Auth OAuth/token Anthropic (incluso il riuso di Claude CLI)	Sì	1 ora
Chiave API	Sì	30 min

Se imposti valori espliciti, OpenClaw non li sovrascrive.

# Abilitare o disabilitare

La potatura è disattivata per impostazione predefinita per i provider non Anthropic. Per abilitarla:

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

Per disabilitarla: imposta mode: "off".

# Potatura vs Compaction

	Potatura	Compaction
Cosa	Riduce i risultati degli strumenti	Riassume la conversazione
Salvata?	No (per richiesta)	Sì (nel transcript)
Ambito	Solo risultati degli strumenti	Intera conversazione

Si completano a vicenda -- la potatura mantiene snelli gli output degli strumenti tra i cicli di Compaction.

# Approfondimenti

• Compaction -- riduzione del contesto basata sul riassunto
• Configurazione Gateway -- tutti i parametri di configurazione della potatura (contextPruning.*)

# Correlati

• Gestione della sessione
• Strumenti della sessione
• Motore di contesto