L’élagage de session d’OpenClaw

La sortie d’outils est ce qui remplit vraiment une longue session. Résultats de commandes, lectures de fichiers et sorties de recherche s’empilent jusqu’à ce que la fenêtre force une compaction qui n’aurait pas eu lieu autrement. L’élagage est l’intervention la moins chère : retirer les anciens résultats de ce que voit le modèle, garder le texte de conversation et la transcription intacts, et garder le cache d’invite utile. Voici comment marchent les deux chemins.

Deux chemins, un réglage

• Mettre le mode d’élagage sur l’option liée à la durée de cache l’active, et le fournisseur, le point de terminaison et l’authentification de la requête décident où il tourne ; l’historique complet est préservé dans les deux cas, parce que l’élagage côté client garde une vue projetée stable en mémoire et l’enregistre dans un marqueur de transcription caché pour que la même vue survive à un redémarrage.
• Les requêtes directes vers Anthropic avec une clé d’API sur le point de terminaison par défaut délèguent au nettoyage des résultats d’outils côté serveur : OpenClaw n’ouvre aucun tour côté client et le serveur efface les anciens résultats avant que le modèle les voie, avec un déclenchement au plus grand de cinquante mille jetons d’entrée ou trente pour cent de la fenêtre, les trois usages d’outils les plus récents conservés, un effacement minimal au plus grand de douze mille cinq cents jetons ou cinq pour cent de la fenêtre, les entrées d’outils préservées, et les outils exclus par la politique laissés de côté.
• L’effacement invalide le cache d’invite à partir du premier résultat effacé, d’où l’effacement minimal : il empêche un événement qui retirerait trop peu de jetons pour justifier l’écriture d’un nouveau cache, et quand un effacement a lieu OpenClaw journalise combien de résultats et de jetons d’entrée sont partis.
• Toutes les autres routes éligibles élaguent côté client selon une échelle : attendre que la durée de cache s’écoule, que chaque requête réussie rafraîchit et qu’un échec ne rafraîchit pas ; estimer le contexte face à la fenêtre et sauter en dessous d’environ trente pour cent d’usage ; couper en douceur les résultats de plus de quatre mille caractères à leurs mille cinq cents premiers et derniers ; les effacer durement quand l’usage reste au-dessus d’environ cinquante pour cent et qu’au moins cinquante mille caractères de contenu élagable subsistent ; puis enregistrer la projection et remettre l’horloge à zéro.

Seuls les messages de résultat d’outil sont éligibles ; le texte de conversation normal est laissé tel quel.

Les règles qui ne plient jamais

Deux règles de sûreté s’appliquent quels que soient les seuils : les trois derniers tours de l’assistant ne sont jamais élagués, et rien avant le premier message utilisateur de la session ne l’est jamais, ce qui protège les lectures d’amorçage qui définissent la personnalité de l’agent et le profil de l’utilisateur. Les seuils et fenêtres de coupe sont un comportement intégré plutôt qu’une configuration ; ce que vous réglez, c’est le mode, la durée de cache, les noms d’outils élagables via une paire d’autorisation et de refus, et si l’effacement dur a lieu ainsi que le texte de remplacement qu’il laisse. La durée conditionne les nouveaux tours, pas le rejeu des projections précédentes, donc les anciens résultats gardent leurs octets projetés à travers les boucles d’outils et les redémarrages pendant que le texte et le contenu non textuel d’origine restent dans la transcription. La compaction abandonne les projections des résultats sortis de l’historique actif, et démarrer une nouvelle session repart sans les anciennes projections.

Images et valeurs par défaut

• Une vue de rejeu idempotente distincte gère les sessions qui gardent des blocs d’image bruts ou des marqueurs de média dans l’historique : les trois derniers tours terminés sont préservés octet pour octet pour que les préfixes de cache récents restent stables, la fenêtre n’avance qu’au début d’un nouveau tour utilisateur, et les anciens blocs d’image déjà traités et les références textuelles de média sont remplacés par des marqueurs de retrait explicites pendant que la transcription brute rend toujours les originaux.
• Le plugin Anthropic livré configure automatiquement l’élagage et la cadence du battement la première fois qu’il résout un profil d’authentification correspondant, et seulement pour les champs que vous n’avez pas définis : l’authentification par jeton reçoit le mode lié au cache avec une durée d’une heure et un battement d’une heure, tandis qu’une clé d’API reçoit le même mode et la même durée avec un battement de trente minutes.
• L’élagage est désactivé par défaut pour les autres fournisseurs, l’activer tient en deux clés, et remettre le mode sur désactivé arrête les nouveaux tours pendant que les projections existantes continuent de se rejouer jusqu’à ce que la compaction retire leurs résultats ou que la session soit réinitialisée.

La compaction OpenClaw est le frère plus lourd qui résume la conversation et Le contexte OpenClaw expliqué le budget que les deux défendent.

Pourquoi cela va avec le cache

Le cache d’invite récompense un préfixe stable, et la sortie d’outils en est la partie la moins stable et la moins précieuse. L’élagage réduit ce qu’il faut mettre en cache et garde les requêtes suivantes sur la version réduite, c’est pourquoi le chemin côté client attend la durée de cache avant de changer quoi que ce soit : élaguer plus tôt invaliderait une entrée de cache qui se payait encore. La même logique explique la vue de rejeu des images, qui existe pour empêcher des charges d’images répétées et des références périmées de casser le cache aux tours suivants. Élagage et compaction se complètent, l’élagage gardant la sortie d’outils légère entre deux cycles de compaction. L’outil exec d’OpenClaw produit l’essentiel de la sortie rognée et Le battement de cœur d’OpenClaw partage les valeurs de cadence décrites plus haut.

Sur Diali

Sur Diali la configuration d’exécution est générée depuis le tableau de bord et remplacée à chaque version, ces valeurs par défaut arrivent donc avec le runtime plutôt que d’être réglées à la main par client. OpenClaw hébergé sur Diali décrit l’assistant hébergé et Les tarifs Diali les offres dans lesquelles il est livré.

• Résultats d’outils seulement ; le texte de conversation n’est jamais touché.
• Les clés Anthropic directes effacent côté serveur ; le reste élague localement.
• Les tours récents et les lectures d’amorçage sont toujours protégés.