Aller au contenu
Guides

La compaction d’OpenClaw

Comment les longues conversations sont résumées pour tenir dans la fenêtre du modèle, le mode de sauvegarde qui audite le résumé, la compaction automatique et la reprise après débordement, la compaction manuelle avec un focus, et les réglages de modèle, d’identifiants et de garde en octets

7 min de lecture

Chaque modèle a une fenêtre de contexte, et toute longue conversation finit par la rencontrer. La compaction est la réponse : les tours anciens deviennent un résumé, les tours récents restent tels quels, et la conversation continue. Ce qui mérite l’attention, c’est tout ce qui entoure cette idée simple, parce que les garde-fous décident si un résumé est digne de confiance et si une compaction ratée peut vous coûter de l’historique.

Le mécanisme

  • Les tours anciens sont résumés en une entrée compacte, le résumé est enregistré dans la transcription de session, et les messages récents restent intacts ; quand le point de coupe tomberait à l’intérieur d’un bloc d’outil, OpenClaw déplace la frontière pour que l’appel d’outil et son résultat correspondant restent ensemble et que la queue non résumée soit préservée.
  • Le résumeur intégré tient compte des caractères chinois, japonais et coréens dans le texte des messages comme dans les arguments d’outils quand il estime la taille des morceaux, et ces budgets sont approximatifs, de sorte qu’un appel d’outil et ses résultats restent ensemble même quand le groupe dépasse la cible.
  • Le résumé reçoit du texte, pas des pixels d’image : les images omises et les autres entrées non textuelles reçoivent des marqueurs explicites plutôt qu’une affirmation qu’un modèle les a traitées, les huit premiers messages concernés reçoivent au plus deux marqueurs chacun et les omissions suivantes une seule mention agrégée, et l’ajout entier est plafonné à 847 octets par requête.
  • Les nouvelles configurations placent le mode de compaction sur sauvegarde, qui applique le budget final avant validation, exige que les titres survivent dans le corps retenu et que les demandes en attente et les identifiants exacts survivent dans le texte stocké, n’accorde que le nombre configuré de tentatives correctives, et s’arrête avant d’écrire une entrée quand rien ne passe, en gardant 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, débordement et manuelle

La compaction automatique est active par défaut et se déclenche quand la session approche de la limite ou quand le fournisseur renvoie une erreur de débordement de contexte, auquel cas OpenClaw compacte puis réessaie ; elle reconnaît des dizaines de messages de débordement propres aux fournisseurs. La reprise après débordement rogne les résultats d’outils dans la fenêtre courante plutôt que de recopier des messages anciens dans de nouvelles entrées. Arrêter une exécution arrête aussi sa reprise, et l’annulation n’est explicitement pas un retour en arrière : une compaction déjà terminée reste dans la transcription et reste comptée. Dans les sessions persistantes, le pointage et la compaction requis ont lieu avant l’inférence tandis que la purge mémoire et la compaction facultatives attendent que la réponse soit livrée, avec un propriétaire de session distinct et le temps restant du tour. La commande manuelle force une compaction et accepte un focus, que l’hôte plafonne à 800 points de code et échappe comme donnée d’invite, et la compaction manuelle côté client garde une queue récente dimensionnée par un budget de jetons qui vaut 20 000 par défaut.

Les réglages qui comptent

  • Une surcharge de modèle choisit un autre modèle de résumé, sous forme de fournisseur et modèle ou d’alias configuré, et sans surcharge la compaction démarre avec le modèle actif de la session ; une erreur de fournisseur éligible au repli refait cette tentative via la chaîne de repli de la session, mais une surcharge explicite reste exacte et n’en hérite pas.
  • La préservation des identifiants est stricte par défaut pour que les identifiants opaques survivent au résumé, une garde en octets sur la transcription active peut déclencher une compaction normale dès que l’historique persisté atteint une taille comme vingt mégaoctets, et un réglage de notification transforme le silence par défaut en brefs messages de début et de fin, plus un avis dégradé quand une purge mémoire préalable a épuisé ses tentatives.
  • Avant de compacter, OpenClaw rappelle à l’agent d’enregistrer ses notes durables dans les fichiers de mémoire, et cette purge est une maintenance facultative : un échec, même après épuisement des tentatives, ne réinitialise pas la session ni ne supprime l’historique, tandis qu’une compaction requise en échec est signalée en laissant la conversation intacte plutôt que de tout recommencer.

Le contexte OpenClaw expliqué est ce que la compaction défend et L’élagage de session d’OpenClaw le complément plus léger qui rogne la sortie d’outils au lieu de résumer.

Fournisseurs, successeurs et plugins

Quand un fournisseur embarqué renvoie une fenêtre compactée, OpenClaw garde le contexte complet renvoyé à côté du point de contrôle, dans une limite de 16 mébioctets, et retombe sur la compaction ordinaire côté client plutôt que de tronquer une sortie trop grande. Si une rédaction retire la fenêtre nécessaire au rejeu, la commande manuelle reconstruit le contexte depuis la conversation enregistrée au lieu de deviner. Un moteur de contexte peut renvoyer une session successeur compactée dans le même agent et le même magasin, qu’OpenClaw publie avant que la maintenance ou les reprises ne l’utilisent, tandis que le compacteur intégré garde l’identité courante et ne crée jamais une seconde transcription. Des plugins peuvent enregistrer un fournisseur de compaction, ce qui force le mode de sauvegarde, reçoit les mêmes instructions et la même politique d’identifiants, et retombe sur le résumeur intégré en cas d’échec ou de résultat vide. Les moteurs de contexte d’OpenClaw couvre cette couche et La recherche mémoire d’OpenClaw la recherche que tout cela garde abordable.

Sur Diali

Sur Diali l’assistant garde l’état de ses sessions sur un volume persistant, la transcription dans laquelle la compaction écrit est donc durable et non un cache ; des instantanés quotidiens et une restauration en un clic sont disponibles grâce à l’option Sauvegardes (incluse avec Max). OpenClaw hébergé sur Diali décrit l’assistant hébergé et Les tarifs Diali les offres dans lesquelles il est livré.

  • Les résumés vont dans la transcription ; l’historique brut reste sur disque.
  • Le mode de sauvegarde échoue fermé plutôt que d’écrire un mauvais résumé.
  • Un appel d’outil et son résultat ne sont jamais séparés par la coupe.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.