Contexte et compaction dans OpenClaw

Le contexte, dans le vocabulaire d’OpenClaw, est tout ce qui est envoyé au modèle pour une exécution, et il est borné par la fenêtre de contexte du modèle. La documentation en donne un modèle pour débutant : l’invite système qu’OpenClaw construit, l’historique de la conversation, et les appels d’outils, leurs résultats et les pièces jointes, et elle prend soin de dire que ce n’est pas la mémoire, qui vit sur disque et se recharge, mais ce qui est dans la fenêtre à cet instant. Voici comment l’inspecter, ce qui le remplit, ce que fait la compaction à l’approche de la limite, et les réglages qui façonnent les deux.

L’inspecter

• La commande d’état montre le remplissage de la fenêtre et les réglages de session ; la commande d’utilisation avec les jetons ajoute un pied de page par réponse.
• La commande de liste du contexte montre ce qui est injecté et sa taille approximative : l’invite système et sa part de contexte de projet, chaque fichier d’espace de travail injecté, la liste des compétences, la liste des outils, et les schémas d’outils, qui comptent dans le contexte sans apparaître comme texte ; la variante détaillée décompose par fichier, par schéma d’outil et par compétence, et la variante carte dessine un treemap des contributeurs de la session.
• Le compteur de l’interface de contrôle utilise le budget d’invite de la dernière exécution quand il correspond encore au modèle et au plafond, en laissant de la place à la réserve de compaction ; c’est une estimation, et la dépasser peut déclencher une réduction des résultats d’outils ou une compaction.

La compaction

Quand une conversation approche de la limite, OpenClaw compacte les tours anciens en un résumé enregistré dans la transcription et garde intacts les messages récents. Il garde les appels d’outils de l’assistant appariés à leurs résultats en choisissant le point de coupe, tient compte des caractères chinois, japonais et coréens dans l’estimation des tailles, et donne au résumeur du texte plutôt que des pixels d’image, avec des marqueurs pour les images omises. Les nouvelles configurations utilisent par défaut un mode de sauvegarde avec des garde-fous plus stricts et un audit de qualité du résumé : les en-têtes requis, les demandes en attente et les identifiants exacts doivent survivre dans le résumé stocké, et si aucune tentative ne passe, la compaction s’arrête sans rien écrire et garde l’historique d’origine.

L’historique complet de la conversation reste sur disque. La compaction ne change que ce que le modèle voit au tour suivant.

Automatique et manuelle

• La compaction automatique est active par défaut : elle s’exécute quand la session approche de la limite, ou quand le modèle renvoie une erreur de dépassement de contexte, auquel cas OpenClaw compacte et réessaie ; des dizaines de chaînes de dépassement propres aux fournisseurs sont reconnues.
• Avant de compacter, OpenClaw rappelle à l’agent d’enregistrer les notes importantes dans ses fichiers de mémoire, ce qui est la façon dont le contexte durable survit au résumé ; la commande d’état compte les compactions, et les journaux montrent des lignes de début et de fin.
• La commande de compaction en force une, avec en option une instruction de focalisation de 800 caractères au plus ; la compaction manuelle garde une queue récente d’environ vingt mille jetons par défaut, et la compaction proactive peut être désactivée dans la configuration tandis que la récupération de dépassement et la compaction manuelle restent disponibles.

La mémoire d’OpenClaw expliquée est là où vont les notes avant une compaction, et Le suivi d’utilisation d’OpenClaw explique les chiffres de jetons dont le compteur est fait.

Ce qui remplit la fenêtre

L’exemple de décomposition de la documentation est instructif : une invite système proche de dix mille jetons, des schémas d’outils proches de huit mille qui n’apparaissent jamais comme texte, une liste de compétences, une liste d’outils, et les fichiers d’espace de travail, le tout avant le premier message. L’invite système d’OpenClaw explique comment cette invite système est assemblée et pourquoi sa moitié stable se trouve au-dessus d’une frontière de cache.

Sur Diali

Sur Diali, la fenêtre est celle du modèle et la compaction celle de l’environnement, tous deux tels que la documentation les décrit ; ce qui change, c’est que le choix du modèle, et donc la taille de la fenêtre, vient du catalogue géré, et que le compteur de crédits montre ce que chaque tour a coûté. OpenClaw hébergé sur Diali est l’assistant.

• Le contexte est le contenu de la fenêtre ; la mémoire est le disque.
• L’état, la liste du contexte et le détail montrent ce qui la remplit.
• La compaction résume l’ancien, garde le récent, et ne supprime jamais la transcription.