Brouillons de progression

Les brouillons de progression donnent de la vie aux longs tours d’agent dans la discussion sans transformer la conversation en pile de réponses d’état temporaires.

Lorsque les brouillons de progression sont activés, OpenClaw crée un seul message visible de travail en cours uniquement après que le tour prouve qu’il effectue un vrai travail, le met à jour pendant que l’agent lit, planifie, appelle des outils ou attend une approbation, puis transforme ce brouillon en réponse finale lorsque le canal peut le faire en toute sécurité.

Shelling...📖 from docs/concepts/progress-drafts.md🔎 Web Search: for "discord edit message"🛠️ Bash: run tests

Utilisez les brouillons de progression lorsque vous voulez un seul message d’état propre pendant un travail intensif en outils, puis la réponse finale lorsque le tour est terminé.

Démarrage rapide

Activez les brouillons de progression par canal avec streaming.mode: "progress" :

{  channels: {    discord: {      streaming: {        mode: "progress",      },    },  },}

Cela suffit généralement. OpenClaw choisira un libellé automatique d’un seul mot, attendra que le travail dure au moins cinq secondes ou émette un deuxième événement de travail, ajoutera des lignes de progression compactes pendant l’exécution d’un travail utile, et supprimera les bavardages autonomes de progression en double pour ce tour.

Ce que voient les utilisateurs

Un brouillon de progression comporte deux parties :

Le libellé apparaît après que l’agent commence un travail significatif et reste occupé pendant cinq secondes ou émet un deuxième événement de travail. Il fait partie de la liste déroulante des lignes de progression, donc l’état de démarrage disparaît du défilement dès qu’assez de travail concret apparaît. Les réponses en texte brut uniquement n’affichent pas de brouillon de progression. Les lignes de progression sont ajoutées uniquement lorsque l’agent émet des mises à jour de travail utiles, par exemple 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message" ou ✍️ Write: to /tmp/file. Par défaut, elles utilisent le même mode d’explication compact que /verbose ; définissez agents.defaults.toolProgressDetail: "raw" lors du débogage si vous voulez aussi que les commandes/détails bruts soient ajoutés. La réponse finale remplace le brouillon lorsque c’est possible ; sinon OpenClaw envoie la réponse finale normalement et nettoie ou cesse de mettre à jour le brouillon selon le transport du canal.

Choisir un mode

channels.<channel>.streaming.mode contrôle le comportement visible en cours :

Choisissez progress lorsque les utilisateurs se soucient davantage de « ce qui se passe » que de regarder le texte de la réponse défiler jeton par jeton.

Choisissez partial lorsque la réponse elle-même est le signal de progression.

Choisissez block lorsque vous voulez des mises à jour d’aperçu du brouillon par morceaux de texte plus grands. Sur Discord et Telegram, streaming.mode: "block" reste une diffusion d’aperçu, pas une livraison normale par blocs. Utilisez streaming.block.enabled ou l’ancien blockStreaming lorsque vous voulez des réponses normales par blocs.

Configurer les libellés

Les libellés de progression se trouvent sous channels.<channel>.streaming.progress.

Le libellé par défaut est auto, qui choisit dans le groupe intégré de libellés d’un seul mot d’OpenClaw :

WorkingShellingScuttlingClawingPinchingMoltingBubblingTidingReefingCrackingSiftingBriningNautilingKrillingBarnaclingLobsteringTidepoolingPearlingSnappingSurfacing

Utilisez un libellé fixe :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          label: "Investigating",        },      },    },  },}

Utilisez votre propre groupe de libellés automatiques :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          label: "auto",          labels: ["Checking", "Reading", "Testing", "Finishing"],        },      },    },  },}

Masquez le libellé et affichez uniquement les lignes de progression :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          label: false,        },      },    },  },}

Contrôler les lignes de progression

Les lignes de progression sont activées par défaut en mode progression. Elles proviennent de vrais événements d’exécution : démarrages d’outils, mises à jour d’éléments, plans de tâches, approbations, sortie de commande, résumés de correctifs et activités similaires de l’agent.

Les outils peuvent aussi émettre une progression typée pendant qu’un seul appel d’outil est encore en cours. C’est ainsi qu’une récupération ou une recherche lente peut mettre à jour le brouillon visible avant que l’outil ne renvoie son résultat final. La mise à jour de progression est un résultat partiel d’outil avec un contenu de modèle vide et des métadonnées explicites de canal public :

{  "content": [],  "progress": {    "text": "Fetching page content...",    "visibility": "channel",    "privacy": "public",    "id": "web_fetch:fetching"  }}

OpenClaw affiche uniquement progress.text dans l’interface de progression du canal. Le résultat normal de l’outil arrive quand même plus tard sous forme de content et de details, et c’est la seule partie renvoyée au modèle.

Lorsque vous ajoutez une progression à un outil, utilisez un message court et générique, puis retardez-le jusqu’à ce que l’opération soit en attente assez longtemps pour être utile :

const clearProgressTimer = scheduleToolProgress(  onUpdate,  { text: "Fetching page content...", id: "web_fetch:fetching" },  5_000,  { signal },); try {  return await runToolWork();} finally {  clearProgressTimer();}

Ce modèle signifie que les appels rapides n’affichent pas de ligne de progression, que les appels longs en affichent une tant qu’ils sont encore en attente, et que les appels annulés effacent le minuteur avant qu’une progression obsolète puisse apparaître. Le texte de progression est un canal latéral d’interface public, il ne doit donc pas inclure de secrets, d’arguments bruts, de contenu récupéré, de sortie de commande ou de texte de page.

OpenClaw utilise le même formateur pour les brouillons de progression et /verbose :

{  agents: {    defaults: {      toolProgressDetail: "explain", // explain | raw    },  },}

"explain" est la valeur par défaut et garde les brouillons stables avec des libellés concis comme 🛠️ check JS syntax for /tmp/app.js. "raw" ajoute la commande/le détail sous-jacent lorsqu’il est disponible, ce qui est utile pendant le débogage mais plus bruyant dans la discussion.

Par exemple, la même commande apparaît différemment selon le mode de détail :

Limitez le nombre de lignes qui restent visibles :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          maxLines: 4,        },      },    },  },}

Les lignes de progression sont compactées automatiquement afin de réduire le réagencement des bulles de discussion pendant la modification du brouillon.

OpenClaw tronque les longues lignes de progression par défaut afin que les modifications répétées du brouillon ne fassent pas des retours à la ligne différents à chaque mise à jour. Le budget par ligne par défaut est de 120 caractères. La prose est coupée à une limite de mot, tandis que les longs détails comme les chemins ou commandes brutes sont raccourcis avec des points de suspension au milieu afin que le suffixe reste visible.

Ajustez le budget par ligne :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          maxLineChars: 160,        },      },    },  },}

Slack peut afficher les lignes de progression sous forme de champs Block Kit structurés plutôt que dans un corps de texte unique :

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          render: "rich",        },      },    },  },}

Le rendu enrichi conserve le même repli en texte brut afin que les canaux et clients qui ne prennent pas en charge la forme plus riche puissent quand même afficher le texte de progression compact.

Conservez le brouillon de progression unique mais masquez les lignes d’outils et de tâches :

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          toolProgress: false,        },      },    },  },}

Avec toolProgress: false, OpenClaw supprime encore les anciens messages autonomes de progression d’outils pour ce tour. Le canal reste visuellement silencieux jusqu’à la réponse finale, sauf pour le libellé si l’un est configuré.

Comportement des canaux

Chaque canal utilise le transport le plus propre qu’il prend en charge :

Les canaux sans prise en charge sûre de la modification se rabattent généralement sur des indicateurs de saisie ou une livraison finale uniquement.

Finalisation

Lorsque la réponse finale est prête, OpenClaw essaie de garder la discussion propre :

• Si le brouillon peut devenir la réponse finale en toute sécurité, OpenClaw le modifie sur place.
• Si le canal utilise une diffusion de progression native, OpenClaw finalise ce flux lorsque le transport natif accepte le texte final.
• Si la réponse finale comporte des médias, une demande d’approbation, une cible de réponse explicite, trop de morceaux, ou un échec de modification/envoi, OpenClaw envoie la réponse finale par le chemin normal de livraison du canal.

Le chemin de repli est intentionnel. Il vaut mieux envoyer une nouvelle réponse finale que perdre du texte, placer une réponse dans le mauvais fil, ou écraser un brouillon avec une charge utile que le canal ne peut pas représenter en toute sécurité.

Dépannage

Je ne vois que la réponse finale.

Vérifiez que channels.<channel>.streaming.mode est défini sur progress pour le compte ou le canal qui a traité le message. Certains chemins de groupe ou de réponse avec citation peuvent désactiver les aperçus de brouillon pour un tour lorsque le canal ne peut pas modifier en toute sécurité le bon message.

Je vois le libellé mais aucune ligne d’outil.

Vérifiez streaming.progress.toolProgress. Si sa valeur est false, OpenClaw conserve le comportement de brouillon unique mais masque les lignes de progression des outils et des tâches.

Je vois un nouveau message final au lieu d’un brouillon modifié.

C’est un repli de sécurité. Cela peut arriver pour les réponses avec médias, les réponses longues, les cibles de réponse explicites, les anciens brouillons Telegram, les cibles de fil Slack manquantes, les messages d’aperçu supprimés, ou l’échec de finalisation d’un flux natif.

Je vois encore des messages de progression autonomes.

Le mode progression supprime les messages autonomes de progression d’outils par défaut lorsqu’un brouillon est actif. Si des messages autonomes apparaissent encore, vérifiez que le tour utilise réellement le mode progression et non streaming.mode: "off" ou un chemin de canal qui ne peut pas créer de brouillon pour ce message.

Teams se comporte différemment de Discord ou Telegram.

Microsoft Teams utilise un flux natif dans les discussions personnelles au lieu du transport générique d’aperçu par envoi et modification. Teams traite aussi streaming.mode: "block" comme une livraison par blocs Teams, car il ne dispose pas du même mode de bloc d’aperçu de brouillon utilisé par Discord et Telegram.

Articles connexes

• Streaming et découpage
• Messages
• Configuration des canaux
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram