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/statut 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 soit occupé pendant cinq secondes, soit émet un deuxième événement de travail. Elle fait partie de la liste déroulante 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, ils 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 en cours :

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 flux 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.

Le libellé par défaut est autoOpenClaw, qui choisit parmi le pool de libellés d’un seul mot intégrés 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.

Les outils peuvent également émettre une progression typée pendant qu’un seul appel d’outil est toujours 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 la progression est un résultat d’outil partiel avec un contenu de modèle vide et des métadonnées publiques de channel explicites :

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

OpenClaw ne rend que le OpenClawprogress.text dans l’interface utilisateur de progression du channel. Le résultat normal de l’outil arrive toujours plus tard sous la 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 et différez-le jusqu’à ce que l’opération ait été en attente suffisamment 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 pendant qu’ils sont toujours en attente, et que les appels annulés effacent la minuterie avant que la progression obsolète ne puisse apparaître. Le texte de progression est un channel latéral de l’interface utilisateur 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 OpenClaw/verbose :

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

"explain" est la valeur par défaut et maintient les brouillons stables avec des libellés concis comme 🛠️ check JS syntax for /tmp/app.js. "raw" ajoute la commande/détail sous-jacente lorsqu’elle est disponible, ce qui est utile lors du 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 reflux des bulles de discussion 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 s’adaptent pas différemment à 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 tels que les chemins ou les commandes brutes sont raccourcis avec des points de suspension au milieu pour que le suffixe reste visible.

Ajuster 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 channels et les clients qui ne prennent pas en charge la forme enrichie 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: false, OpenClaw supprime toujours les anciens messages autonomes de progression d’outil pour ce tour. Le channel reste visuellement silencieux jusqu’à la réponse finale, à l’exception de l’étiquette si une est configurée.

Comportement du channel

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

Channel	Transport de progression	Notes
Discord	Envoyer un message, puis le modifier.	Le texte final est modifié sur place lorsqu’il tient dans un seul message de prévisualisation 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 Teams natif dans les discussions personnelles.	streaming.mode: "block" correspond à la livraison par bloc Teams.
Slack	Flux natif ou publication de brouillon modifiable.	La disponibilité des fils affecte la possibilité d’utiliser le streaming natif.
Telegram	Envoyer un message, puis le modifier.	Les anciens brouillons visibles peuvent être remplacés afin que les horodatages finaux restent utiles.
Mattermost	Publication de brouillon modifiable.	L’activité de l’outil est intégrée dans la même publication de style brouillon.

Les channels sans prise en charge de modification sécurisée 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 le streaming de progression natif, 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 une modification ou un envoi a échoué, OpenClaw envoie la réponse finale via le chemin de livraison normal 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 utile 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 aucune ligne d’outil.

Vérifiez streaming.progress.toolProgress. S’il est défini sur false, OpenClaw conserve le comportement de brouillon unique mais masque les lignes de progression des outils et des tâches.

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

Il s’agit d’un repli de sécurité. Cela peut se produire pour les réponses média, 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 de flux natif échouée.

Je vois toujours des messages de progression autonomes.

Le mode progression supprime les messages autonomes par défaut de progression des outils lorsqu’un brouillon est actif. Si des messages autonomes apparaissent toujours, vérifiez que le tour utilise le mode progression et non streaming.mode: "off" ou un chemin de channel 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 conversations personnelles au lieu du transport d’aperçu générique d’envoi et de modification. Teams traite également streaming.mode: "block" comme une livraison de bloc Teams car il ne dispose pas du même mode de bloc d’aperçu de brouillon utilisé par Discord et Telegram.

Connexes

• Streaming and chunking
• Messages
• Channel configuration
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram