Élagage de session

L’élagage de session supprime les anciens résultats d’outils du contexte avant chaque appel LLM. Il réduit le gonflement du contexte dû à l’accumulation de sorties d’outils (résultats d’exécution, lectures de fichiers, résultats de recherche) sans réécrire le texte normal de la conversation.

# 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 utile pour le cache de prompt Anthropic. Après expiration de la durée de vie 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

1. Attendre l’expiration de la durée de vie du cache (5 minutes par défaut).
2. Rechercher les anciens résultats d’outils pour l’élagage normal (le texte de la conversation reste intact).
3. Soft-trim des résultats surdimensionnés -- conserver le début et la fin, insérer ....
4. Hard-clear du reste -- remplacer par un espace réservé.
5. Réinitialiser la durée de vie afin que les requêtes suivantes réutilisent le cache actualisé.

# Nettoyage des anciennes images

OpenClaw construit également une vue de relecture idempotente distincte pour les sessions qui conservent des blocs d’image bruts ou des marqueurs média d’hydratation de prompt dans l’historique.

• Elle préserve les 3 tours terminés les plus récents octet pour octet afin que les préfixes de cache de prompt pour les suivis récents restent stables.
• Dans la vue de relecture, les anciens blocs d’image déjà traités provenant de l’historique user ou toolResult peuvent être remplacés par [image data removed - already processed by model].
• Les anciennes références média textuelles telles que [media attached: ...], [Image: source: ...] et media://inbound/... peuvent être remplacées par [media reference removed - already processed by model]. Les marqueurs de pièce jointe du tour en cours restent intacts afin que les modèles de vision puissent toujours hydrater les nouvelles images.
• La transcription brute de la session n’est pas réécrite ; les visionneuses d’historique peuvent donc toujours afficher les entrées de message d’origine et leurs images.
• Ceci est distinct de l’élagage normal fondé sur la durée de vie du cache. Cela existe pour empêcher que des charges utiles d’image répétées ou des références média obsolètes ne fassent échouer les caches de prompt lors des tours suivants.

# Valeurs par défaut intelligentes

OpenClaw active automatiquement l’élagage pour les profils Anthropic :

Type de profil	Élagage activé	Heartbeat
Authentification OAuth/token Anthropic (y compris la réutilisation de Claude CLI)	Oui	1 heure
Clé API	Oui	30 min

Si vous définissez des valeurs explicites, OpenClaw ne les remplace pas.

# 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" },
    },
  },
}

Pour le désactiver : définissez mode: "off".

# Élagage vs Compaction

	Élagage	Compaction
Quoi	Supprime 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

Ils se complètent -- l’élagage garde des sorties d’outils légères entre les cycles de Compaction.

# Pour aller plus loin

• Compaction -- réduction du contexte fondée sur la synthèse
• Configuration de la Gateway -- tous les réglages de configuration de l’élagage (contextPruning.*)

# Liens connexes

• Gestion de session
• Outils de session
• Moteur de contexte