Progress drafts

Les brouillons de progression (progress drafts) donnent vie aux tours d’agent longs dans le chat sans transformer la conversation en une pile de réponses de statut temporaires.

Lorsque les brouillons de progression sont activés, OpenClaw crée un seul message de travail en cours visible seulement après que le tour a prouvé qu’il effectuait un vrai travail, le met à jour pendant que l’agent lit, planifie, appelle des outils ou attend une approbation, puis transforme ce brouillon en la réponse finale lorsque le channel 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 message de statut soigné pendant un travail intensif en outils et la réponse finale lorsque le tour est terminé.

Quick start

Activez les progress drafts par channel avec streaming.mode: "progress" :

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

C’est généralement suffisant. OpenClaw choisira une étiquette automatique d’un 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 qu’un travail utile se produit, et supprimera les bavardages de progression autonomes en double pour ce tour.

Ce que voient les utilisateurs

Un brouillon de progression comprend deux parties :

Partie	Objectif
Étiquette	Une courte ligne de démarrage/état telle que `Working` ou `Shelling`.
Lignes de progression	Mises à jour d’exécution compactes utilisant les mêmes icônes d’outils et le même formateur de détail que la sortie verbeuse.

L’étiquette apparaît après que l’agent a commencé un travail significatif et reste occupé pendant cinq secondes ou émet un deuxième événement de travail. Elle fait partie de la liste défilante des lignes de progression, donc le statut de démarrage disparaît une fois que suffisamment de travail concret apparaît. Les réponses en texte brut ne montrent pas de progress draft. 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 souhaitez également 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 arrête de mettre à jour le brouillon en fonction du transport du channel.

Choisir un mode

channels.<channel>.streaming.mode contrôle le comportement visible de progression :

Mode	Idéal pour	Ce qui apparaît dans le chat
`off`	Channels calmes	Uniquement la réponse finale.
`partial`	Regarder le texte de la réponse apparaître	Un brouillon édité avec le dernier texte de la réponse.
`block`	Grands blocs d’aperçu de réponse	Un aperçu mis à jour ou ajouté par blocs plus importants.
`progress`	Tours intensifs en outils ou de longue durée	Un brouillon d’état, puis la réponse finale.

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

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

Choisissez block lorsque vous souhaitez des mises à jour d’aperçu du brouillon en gros blocs de texte. Sur Discord et Telegram, streaming.mode: "block" est toujours un streaming d’aperçu, et non une livraison en bloc normale. Utilisez streaming.block.enabled ou l’ancien blockStreaming lorsque vous souhaitez des réponses en bloc normales.

Configurer les étiquettes

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

L’étiquette par défaut est auto, qui choisit parmi le pool d’étiquettes à un seul mot intégré d’OpenClaw :

Working
Shelling
Scuttling
Clawing
Pinching
Molting
Bubbling
Tiding
Reefing
Cracking
Sifting
Brining
Nautiling
Krilling
Barnacling
Lobstering
Tidepooling
Pearling
Snapping
Surfacing

Utiliser une étiquette fixe :

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

Utilisez votre propre pool d’étiquettes automatiques :

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

Masquer l’étiquette et afficher 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 d’événements d’exécution réels : démarrages d’outils, mises à jour d’éléments, plans de tâches, approbations, sorties de commandes, résumés de correctifs et d’autres activités similaires de l’agent.

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

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

"explain" est la valeur par défaut et maintient les brouillons stables avec des étiquettes concises comme 🛠️ check JS syntax for /tmp/app.js. "raw" ajoute la commande/détail sous-jacente lorsqu’elle est disponible, ce qui est utile pendant le débogage mais plus bruyant dans le chat.

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

Mode	Ligne de progression
`explain`	`🛠️ check JS syntax for /tmp/app.js`
`raw`	`🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js`

Limiter le nombre de lignes visibles :

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

Les lignes de progression sont compactées automatiquement pour réduire le reflow des bulles de chat pendant que le brouillon est édité.

OpenClaw tronque les longues lignes de progression par défaut afin que les modifications répétées du brouillon ne se retrouvent pas à la ligne différemment à chaque mise à jour. Le budget par défaut par ligne est de 120 caractères. La prose est coupée à une limite de mot, tandis que les longs détails tels que les chemins ou les 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 structurés Block Kit au lieu d’un corps de texte unique :

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

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

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

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

Avec toolProgress: falseOpenClaw, OpenClaw supprime toujours les anciens messages de progression d’outil autonomes pour ce tour. Le canal reste visuellement silencieux jusqu’à la réponse finale, à l’exception de l’étiquette si une est configurée.

Comportement du canal

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

Canal	Transport de progression	Notes
Discord	Envoyer un message, puis le modifier.	Modifie le texte final sur place lorsqu’il tient dans un seul message d’aperçu sûr.
Matrix	Envoyer un événement, puis le modifier.	La configuration du streaming au niveau du compte contrôle les brouillons au niveau du compte.
Microsoft Teams	Flux natif Teams dans les conversations personnelles.	`streaming.mode: "block"` correspond à la livraison par bloc Teams.
Slack	Flux natif ou message de brouillon modifiable.	La disponibilité des fils de discussion affecte la possibilité d’utiliser le streaming natif.
Telegram	Envoyez un seul message, puis modifiez-le.	Les anciens brouillons visibles peuvent être remplacés pour que les horodatages finaux restent utiles.
Mattermost	Brouillon de message modifiable.	L’activité des outils est intégrée dans le même message de type brouillon.

Les channels sans support sécurisé de l’édition reviennent généralement aux indicateurs de frappe ou à la livraison finale uniquement.

Finalisation

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

Si le brouillon peut devenir en toute sécurité la réponse finale, OpenClaw le modifie sur place.
Si le channel utilise la diffusion de progrès native, OpenClaw finalise ce flux lorsque le transport natif accepte le texte final.
Si la réponse finale contient des médias, une invite d’approbation, une cible de réponse explicite, trop de fragments ou si l’édition/l’envoi échoue, OpenClaw envoie la réponse finale via le chemin normal de livraison du channel.

Le chemin de repli est intentionnel. Il est préférable d’envoyer une nouvelle réponse finale que de perdre du texte, mal classer une réponse ou écraser un brouillon avec une charge que le channel 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 channel qui a géré le message. Certains chemins de groupe ou de réponse en citation peuvent désactiver les aperçus de brouillon pour un tour lorsque le channel ne peut pas modifier en toute sécurité le bon message.

Je vois l’étiquette mais pas les lignes d’outils.

Vérifiez streaming.progress.toolProgress. Si c’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é.

Il s’agit d’un repli de sécurité. Cela peut se produire pour les réponses multimédias, les réponses longues, les cibles de réponse explicites, les anciens brouillons Telegram, les cibles de fil de discussion Slack manquantes, les messages d’aperçu supprimés ou une finalisation échouée du flux natif.

Je vois toujours des messages de progrès autonomes.

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

** se comporte différemment de ou .**

utilise un flux natif dans les conversations personnelles au lieu du transport d’aperçu d’envoi et de modification générique. Teams traite également Microsoft Teamsstreaming.mode: "block"DiscordTelegram comme une livraison de bloc Teams car il ne possède pas le même mode de bloc d’aperçu de brouillon utilisé par et .