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.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
La potatura è solo in memoria — non modifica il transcript della sessione su disco.
La cronologia completa viene sempre preservata.
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
- Attendi la scadenza del TTL della cache (predefinito 5 minuti).
- Trova i vecchi risultati degli strumenti per la normale potatura (il testo della conversazione resta invariato).
- Soft-trim dei risultati sovradimensionati — mantieni testa e coda, inserisci
.... - Hard-clear del resto — sostituiscilo con un segnaposto.
- 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
userotoolResultpossono essere sostituiti con[image data removed - already processed by model]. - I vecchi riferimenti media testuali come
[media attached: ...],[Image: source: ...]emedia://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 |
Abilitare o disabilitare
La potatura è disattivata per impostazione predefinita per i provider non Anthropic. Per abilitarla: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 |
Approfondimenti
- Compaction — riduzione del contesto basata sul riassunto
- Configurazione Gateway — tutti i parametri di configurazione della potatura
(
contextPruning.*)