Élagage de session
L’élagage de session réduit les anciens résultats d’outils du contexte avant chaque
appel LLM. Il diminue le gonflement du contexte causé par l’accumulation de sorties d’outils (résultats d’exec, lectures de fichiers, résultats de recherche) sans réécrire le texte normal de la conversation.
L’élagage agit uniquement en mémoire — il ne modifie pas la transcription de session sur disque.
Votre historique complet est toujours conservé.
Pourquoi c’est important
Les longues sessions accumulent des sorties d’outils qui gonflent la fenêtre de contexte. Cela
augmente le coût et peut forcer la compaction plus tôt que
nécessaire.
L’élagage est particulièrement précieux pour la mise en cache des prompts Anthropic. Après l’expiration du TTL du cache,
la requête suivante remet en cache l’intégralité du prompt. L’élagage réduit la taille d’écriture du
cache, ce qui diminue directement le coût.
Fonctionnement
- Attendre l’expiration du TTL du cache (5 minutes par défaut).
- Trouver les anciens résultats d’outils pour l’élagage normal (le texte de conversation est laissé intact).
- Réduction douce des résultats trop volumineux — conserver le début et la fin, insérer
....
- Effacement strict du reste — remplacer par un espace réservé.
- Réinitialiser le TTL pour que les requêtes suivantes réutilisent le cache rafraîchi.
Nettoyage historique des images
OpenClaw exécute également un nettoyage idempotent séparé pour les anciennes sessions historiques qui conservaient des blocs d’image bruts dans l’historique.
- Il préserve les 3 tours terminés les plus récents octet pour octet afin que les préfixes du cache de prompt pour les suivis récents restent stables.
- Les anciens blocs d’image déjà traités dans l’historique
user ou toolResult peuvent être remplacés par [image data removed - already processed by model].
- Cela est distinct de l’élagage normal basé sur le TTL du cache. Cela existe pour empêcher des charges utiles d’image répétées d’invalider les caches de prompt lors de tours ultérieurs.
Valeurs par défaut intelligentes
OpenClaw active automatiquement l’élagage pour les profils Anthropic :
| Type de profil | Élagage activé | Heartbeat |
|---|
| Auth OAuth/jeton Anthropic (y compris la réutilisation Claude CLI) | Oui | 1 heure |
| Clé API | Oui | 30 min |
Activer ou désactiver
L’élagage est désactivé par défaut pour les fournisseurs non Anthropic. Pour l’activer :
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
mode: "off".
Élagage vs compaction
| Élagage | Compaction |
|---|
| Quoi | Réduit les résultats d’outils | Résume la conversation |
| Enregistré ? | Non (par requête) | Oui (dans la transcription) |
| Portée | Résultats d’outils uniquement | Conversation entière |
Pour aller plus loin
