Borradores de progreso

Los borradores de progreso convierten un mensaje del canal en una línea de estado en vivo mientras un agente trabaja, en lugar de crear una pila de respuestas temporales del tipo «todavía trabajando». Establezca channels.<channel>.streaming.mode: "progress" y OpenClaw crea el mensaje cuando comienza el trabajo real, lo edita mientras el agente lee, planifica, llama a herramientas o espera aprobación y, después, lo convierte en la respuesta final.

Ejecutando shell...📖 desde docs/concepts/progress-drafts.md🔎 Búsqueda web: de "discord edit message"🛠️ Bash: ejecutar pruebas

Inicio rápido

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

Valores predeterminados a partir de aquí: un retraso inicial de 5 segundos (o inmediato al producirse un segundo evento de trabajo), líneas de progreso compactas mientras se realiza trabajo útil y supresión de los mensajes de progreso independientes anteriores para ese turno. Los borradores de líneas de herramientas sin procesar usan una etiqueta automática de una palabra; el estado narrado omite ese título redundante salvo que se configure uno explícitamente.

Esta página trata sobre la experiencia de los borradores de progreso y sus opciones de configuración. Para consultar la matriz completa de modos de transmisión, las notas de ejecución por canal y la migración de claves heredadas, consulte Transmisión y fragmentación.

Lo que ven los usuarios

Para el progreso sin procesar de las herramientas, la etiqueta aparece cuando el agente comienza un trabajo significativo y sigue ocupado durante el retraso inicial, o cuando se produce inmediatamente un segundo evento de trabajo. Se sitúa en la parte superior de la lista móvil de líneas de progreso, por lo que desaparece al desplazarse cuando aparecen suficientes líneas de trabajo concretas. El progreso narrado muestra únicamente el estado del agente en lenguaje natural, salvo que se configure explícitamente una etiqueta. Las respuestas que contienen solo texto nunca muestran un borrador de progreso; solo aparece una línea para actualizaciones de trabajo reales, por ejemplo 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message" o ✍️ Write: to /tmp/file.

La respuesta final sustituye al borrador en el mismo lugar cuando el canal puede hacerlo de forma segura; de lo contrario, OpenClaw envía la respuesta final mediante la entrega normal y elimina el borrador o deja de actualizarlo (consulte Finalización).

Elegir un modo

channels.<channel>.streaming.mode controla el comportamiento visible durante el proceso:

Elija progress cuando a los usuarios les importe más «qué está sucediendo» que ver cómo se transmite el texto de la respuesta token por token; partial cuando el propio texto de la respuesta sea la señal de progreso; y block para fragmentos de vista previa más grandes. En Discord y Telegram, streaming.mode: "block" sigue siendo transmisión de vista previa, no entrega normal de respuestas por bloques; use streaming.block.enabled para ello.

Configurar etiquetas

Las etiquetas de progreso se encuentran en channels.<channel>.streaming.progress. La etiqueta predeterminada para las líneas de herramientas sin procesar es "auto", que elige una opción del conjunto integrado de etiquetas de una sola palabra de OpenClaw. El progreso narrado oculta esa etiqueta implícita; establezca label: "auto" explícitamente si también desea mostrarla sobre la narración:

Trabajando, Ejecutando shell, Desplazándose, Arañando, Pellizcando, Mudando, Burbujeando, Mareando,Formando arrecifes, Quebrando, Tamizando, Poniendo en salmuera, Nautilando, Krilleando, Cubriendo de percebes,Langosteando, Formando pozas de marea, Formando perlas, Chasqueando, Emergiendo

Use una etiqueta fija:

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

Use su propio conjunto de etiquetas (se siguen eligiendo al azar o por semilla cuando label: "auto"):

{  channels: {    discord: {      streaming: {        mode: "progress",        progress: {          label: "auto",          labels: ["Comprobando", "Leyendo", "Probando", "Finalizando"],        },      },    },  },}

Oculte la etiqueta y muestre únicamente las líneas de progreso:

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

Controlar las líneas de progreso

Las líneas de progreso provienen de eventos de ejecución reales: inicios de herramientas, actualizaciones de elementos, planes de tareas, aprobaciones, salida de comandos, resúmenes de parches y actividades similares del agente. Están habilitadas de forma predeterminada (progress.toolProgress, valor predeterminado true).

Las herramientas también pueden emitir progreso tipado mientras una llamada sigue en ejecución. Así es como una obtención o búsqueda lenta actualiza el borrador visible antes de que la herramienta devuelva su resultado final. La actualización de progreso es un resultado parcial de la herramienta con contenido del modelo vacío y metadatos explícitos del canal público:

{  "content": [],  "progress": {    "text": "Obteniendo el contenido de la página...",    "visibility": "channel",    "privacy": "public",    "id": "web_fetch:fetching"  }}

OpenClaw representa únicamente progress.text en la interfaz de progreso del canal. El resultado normal de la herramienta llega posteriormente como content/details y es la única parte que se devuelve al modelo.

Al añadir progreso a una herramienta, emita un mensaje breve y genérico, y retráselo hasta que la operación lleve pendiente el tiempo suficiente para resultar útil. web_fetch hace exactamente esto con un retraso de 5 segundos:

const clearProgressTimer = scheduleToolProgress(  onUpdate,  { text: "Obteniendo el contenido de la página...", id: "web_fetch:fetching" },  5_000,  { signal },); try {  return await runToolWork();} finally {  clearProgressTimer();}

Las llamadas rápidas no muestran ninguna línea de progreso; las llamadas largas muestran una mientras siguen pendientes; las llamadas canceladas borran el temporizador antes de que pueda aparecer progreso obsoleto. El texto de progreso es un canal lateral público de la interfaz de usuario, por lo que nunca debe incluir secretos, argumentos sin procesar, contenido obtenido, salida de comandos ni texto de páginas.

Modo detallado

OpenClaw usa el mismo formateador para los borradores de progreso y /verbose:

{  agents: {    defaults: {      toolProgressDetail: "explain", // explicar | sin procesar    },  },}

"explain" es el valor predeterminado y mantiene los borradores estables con etiquetas concisas. "raw" añade el comando subyacente cuando está disponible, lo que resulta útil al depurar, pero genera más ruido en el chat. Por ejemplo, una llamada a node --check /tmp/app.js se muestra de forma distinta según el modo:

Texto de comando/exec

streaming.progress.commandText (valor predeterminado: "raw") controla cuánto detalle del comando se muestra junto a las líneas de progreso de exec/bash, independientemente del modo de detalle anterior. Establézcalo en "status" para mantener visible una línea de progreso de la herramienta mientras se oculta por completo el texto del comando:

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

Canal de comentarios

streaming.progress.commentary (valor predeterminado: false) intercala la narración de comentarios o preámbulo del modelo previa al uso de herramientas (💬, por ejemplo, «Comprobaré... y luego...») con las líneas de herramientas en el borrador. Consulte Transmisión y fragmentación para conocer la estructura de configuración compartida entre canales.

Estado narrado

Cuando se resuelve un modelo auxiliar para el agente —un utilityModel explícito o el modelo pequeño predeterminado declarado por el proveedor principal (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5)—, el borrador de progreso sustituye las líneas continuas de herramientas por una breve narración en lenguaje sencillo de lo que hace el agente, redactada por ese modelo más económico y actualizada a medida que avanza el trabajo:

Actualizando el modelo predeterminado en la configuración y, después, reiniciando el Gateway para aplicar el cambio. Una llamada para enumerar agentes ha fallado y se está reintentando.

La narración está activada de forma predeterminada (streaming.progress.narration, valor predeterminado: true) y nunca recurre al modelo principal: solo se ejecuta con un utilityModel explícito o con un valor predeterminado declarado por el proveedor principal del agente. Establezca utilityModel: "" para desactivar por completo el enrutamiento auxiliar. Las líneas de herramientas siguen acumulándose debajo y vuelven a mostrarse si la narración se detiene; además, el borrador solo se edita después del umbral de actividad normal y cuando el texto de la narración cambia realmente, lo que evita parpadeos en turnos rápidos y reduce la sucesión de ediciones en canales con mucha actividad. Desactive esta opción para conservar las líneas de herramientas sin procesar:

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

La entrada de narración está acotada y censurada: el modelo auxiliar recibe el texto de la solicitud entrante junto con los mismos resúmenes de herramientas compactos y censurados que mostraría el borrador, nunca la salida sin procesar de los comandos ni los resultados de las herramientas. Con commandText: "status", la entrada de narración también omite el texto de los comandos exec/bash, de acuerdo con lo que muestra el borrador.

Límites de líneas

Limite cuántas líneas permanecen visibles (valor predeterminado: 8):

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

Las líneas de progreso se compactan automáticamente para reducir la redistribución de los globos de chat mientras se edita el borrador, y OpenClaw trunca las líneas largas para que las ediciones repetidas del borrador no ajusten el texto de forma diferente en cada actualización. El límite predeterminado por línea es de 120 caracteres; la prosa se corta en un límite de palabra, mientras que los detalles largos, como rutas o comandos sin procesar, se acortan con puntos suspensivos intermedios para que el sufijo permanezca visible.

Ajuste el límite por línea:

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

Representación enriquecida (Slack)

Slack puede representar las líneas de progreso como campos estructurados de Block Kit en lugar de texto sin formato:

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

La representación enriquecida siempre envía el mismo cuerpo de texto sin formato junto con los campos de Block Kit, por lo que los clientes que no pueden representar el formato enriquecido siguen mostrando el texto de progreso compacto.

Ocultar líneas de herramientas y tareas

Mantenga el único borrador de progreso, pero oculte las líneas de herramientas y tareas:

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

Con toolProgress: false, OpenClaw sigue suprimiendo los antiguos mensajes independientes de progreso de herramientas para ese turno; el canal permanece visualmente despejado hasta la respuesta final, excepto por la etiqueta si se ha configurado una.

Comportamiento del canal

Los canales sin compatibilidad segura con la edición recurren a indicadores de escritura o a la entrega únicamente de la respuesta final. Consulte Streaming y fragmentación para ver el desglose completo del comportamiento en tiempo de ejecución de cada canal.

Finalización

Cuando la respuesta final está lista, OpenClaw intenta mantener limpio el chat:

• En el modo progress de Discord, la respuesta final se envía como un mensaje nuevo con un pequeño comprobante de actividad -# añadido (por ejemplo, -# 🧠 2 thoughts · 🛠️ 5 tool calls · ⏱️ 12s), y el borrador de estado se elimina una vez entregada esa respuesta. Los canales con actividad no conservan ningún registro de herramientas huérfano encima de la respuesta; en caso de error final, el borrador se conserva como registro visible del turno fallido.
• Si el borrador puede convertirse de forma segura en la respuesta final (modos partial/block), OpenClaw lo edita en el mismo lugar.
• Si el canal utiliza transmisión nativa del progreso, OpenClaw finaliza esa transmisión cuando el transporte nativo acepta el texto final.
• En caso contrario (contenido multimedia, una solicitud de aprobación, un destino de respuesta explícito, demasiados fragmentos o un fallo de edición/envío), OpenClaw envía la respuesta final mediante la ruta normal de entrega del canal en lugar de sobrescribir el borrador.

La alternativa es intencional: enviar una respuesta final nueva es preferible a perder texto, asociar incorrectamente una respuesta a un hilo o sobrescribir un borrador con una carga útil que el canal no puede representar de forma segura.

Solución de problemas

Solo veo la respuesta final.

Compruebe que channels.<channel>.streaming.mode sea progress para la cuenta o el canal que procesó el mensaje. Algunas rutas de grupo o de respuesta con cita desactivan las vistas previas del borrador durante un turno cuando el canal no puede editar de forma segura el mensaje correcto.

Veo la etiqueta, pero no las líneas de herramientas.

Comprueba streaming.progress.toolProgress. Si es false, OpenClaw mantiene el comportamiento de borrador único, pero oculta las líneas de progreso de herramientas y tareas.

Veo un mensaje final nuevo en lugar de un borrador editado.

Es el mecanismo alternativo de seguridad descrito en Finalización. Puede ocurrir con respuestas multimedia, respuestas largas, destinos de respuesta explícitos, borradores antiguos de Telegram, destinos de hilo de Slack ausentes, mensajes de vista previa eliminados o una finalización fallida del flujo nativo.

Sigo viendo mensajes de progreso independientes.

El modo de progreso suprime los mensajes independientes predeterminados sobre el progreso de las herramientas siempre que haya un borrador activo. Si siguen apareciendo mensajes independientes, confirma que el turno esté usando realmente el modo progress y no streaming.mode: "off" ni una ruta de canal que no pueda crear un borrador para ese mensaje.

Teams se comporta de forma diferente a Discord o Telegram.

Microsoft Teams usa un flujo nativo en los chats personales en lugar del transporte genérico de vista previa basado en enviar y editar, y asigna streaming.mode: "block" a la entrega por bloques de Teams porque no tiene un modo de bloques de vista previa en borrador como Discord y Telegram.

Relacionado

• Transmisión y fragmentación
• Mensajes
• Configuración de canales
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram
• Mattermost