Compactage

Compactage

Chaque modèle possède une fenêtre de contexte — le nombre maximum de jetons qu’il peut traiter. Lorsqu’une conversation approche cette limite, OpenClaw compacte les anciens messages dans un résumé afin que la discussion puisse continuer.

Fonctionnement

1. Les anciens tours de conversation sont résumés en une entrée compacte.
2. Le résumé est enregistré dans la transcription de la session.
3. Les messages récents sont conservés intacts.

L’historique complet de la conversation reste sur le disque. Le compactage ne modifie que ce que le modèle voit au tour suivant.

Auto-compactage

L’auto-compactage est activé par défaut. Il s’exécute lorsque la session approche la limite de contexte, ou lorsque le modèle renvoie une erreur de dépassement de contexte (auquel cas OpenClaw compactera et réessayera).

Info

Avant de compacter, OpenClaw rappelle automatiquement à l’agent d’enregistrer des notes importantes dans les fichiers

mémoire

. Cela évite la perte de contexte.

Compactage manuel

Tapez /compact dans n’importe quel chat pour forcer un compactage. Ajoutez des instructions pour guider le résumé :

/compact Focus on the API design decisions

Utiliser un modèle différent

Par défaut, le compactage utilise le modèle principal de votre agent. Vous pouvez utiliser un modèle plus performant pour de meilleurs résumés :

{
  agents: {
    defaults: {
      compaction: {
        model: "openrouter/anthropic/claude-sonnet-4-6",
      },
    },
  },
}

Compactage vs élagage

	Compactage	Élagage
Ce qu’il fait	Résume l’ancienne conversation	Supprime les anciens résultats d’outils
Sauvegardé ?	Oui (dans la transcription de session)	Non (en mémoire uniquement, par requête)
Portée	Conversation entière	Résultats des outils uniquement

L’élagage de session est un complément plus léger qui réduit la sortie des outils sans résumer.

Dépannage

Compactage trop fréquent ? La fenêtre de contexte du modèle peut être petite, ou les sorties d’outils peuvent être volumineuses. Essayez d’activer l’élagage de session.

Le contexte semble périmé après compactage ? Utilisez /compact Focus on <topic> pour guider le résumé, ou activez la vidange de la mémoire afin que les notes soient conservées.

Besoin d’un nouveau départ ? /new lance une nouvelle session sans compactage.

Pour une configuration avancée (réservation de jetons, préservation des identifiants, moteurs de contexte personnalisés, compactage côté serveur OpenAI), consultez la section Approfondissement de la gestion de session.

Liens connexes

• Session — gestion et cycle de vie de session
• Élagage de session — rognage des résultats des outils
• Contexte — construction du contexte pour les tours de l’agent
• Hooks — hooks de cycle de vie du compactage (before_compaction, after_compaction)