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 una pila de respuestas temporales de «aún trabajando». Establezca channels.<channel>.streaming.mode: "progress" y OpenClaw creará el mensaje cuando comience el trabajo real, lo editará a medida que el agente lea, planifique, llame a herramientas o espere aprobación y, luego, lo convertirá en la respuesta final.

Trabajando...📖 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, líneas de progreso compactas mientras se realiza trabajo útil y supresión de los antiguos mensajes de progreso independientes para ese turno. Los borradores de líneas de herramientas sin procesar usan una etiqueta automática de una palabra; un encabezado de estado omite ese título redundante a menos que se configure uno explícitamente.

Esta página abarca 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.

Qué ven los usuarios

Para el progreso de herramientas sin procesar, la etiqueta aparece cuando el agente comienza un trabajo significativo y permanece ocupado durante el retraso inicial. Se sitúa en la parte superior de la lista desplazable de líneas de progreso, por lo que desaparece al desplazarse cuando aparecen suficientes líneas de trabajo concretas. Un encabezado de estado muestra únicamente el estado del agente en lenguaje natural, salvo que se configure explícitamente una etiqueta. Las respuestas que solo contienen 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 limpia el borrador o deja de actualizarlo (consulte Finalización).

Elegir un modo

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

Elija progress cuando a los usuarios les importe más «qué está ocurriendo» que ver el texto de la respuesta transmitirse token por token; partial cuando el propio texto de la respuesta sea la señal de progreso; block para fragmentos mayores de vista previa. 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 eso.

Configurar etiquetas

Las etiquetas de progreso se encuentran bajo channels.<channel>.streaming.progress. La etiqueta predeterminada para líneas de herramientas sin procesar es "auto", que usa la sencilla etiqueta integrada Working. Un encabezado de estado oculta esa etiqueta implícita; establezca label: "auto" explícitamente si también desea una etiqueta encima:

Trabajando

Usar una etiqueta fija:

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

Usar un conjunto propio de etiquetas (se siguen eligiendo al azar/por semilla cuando label: "auto"):

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

Ocultar la etiqueta y mostrar ú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 proceden de eventos reales de ejecución: inicio 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 sola llamada sigue en ejecución. Así, 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 sigue llegando posteriormente como content/details y es la única parte devuelta 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 de interfaz pública, por lo que nunca debe incluir secretos, argumentos sin procesar, contenido obtenido, salida de comandos ni texto de páginas.

Modo de detalle

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

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

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

Texto de comandos/ejecución

streaming.progress.commandText (valor predeterminado "raw") controla cuánto detalle del comando aparece junto a las líneas de progreso de ejecución/bash, independientemente del modo de detalle anterior. Establézcalo en "status" para mantener visible una línea de progreso de 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/preámbulo del modelo previa a las herramientas (💬, por ejemplo «Comprobaré... y después ...»), con las líneas de herramientas del borrador. Consulte Transmisión y fragmentación para ver la estructura de configuración compartida entre canales.

Con el canal de comentarios habilitado, los preámbulos solo se representan como esas líneas 💬 intercaladas; el encabezado de estado que aparece a continuación no interfiere, de modo que el canal conserva su estructura documentada.

Encabezado de estado

En Discord y Telegram, en el modo de progreso, el preámbulo tipado del modelo previo a las herramientas se convierte en el encabezado de estado del borrador siempre que esté disponible. Los demás canales en modo de progreso conservan su comportamiento de estado existente. El encabezado está habilitado de forma predeterminada y no omite el control de actividad normal para turnos breves; habilitar streaming.progress.commentary envía en su lugar los preámbulos al canal de comentarios intercalado.

En Discord, cuando se resuelve un modelo auxiliar para el agente —un utilityModel explícito o el valor predeterminado de modelo pequeño declarado por el proveedor principal (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5)—, este proporciona un breve texto de relleno en lenguaje natural cuando el modelo no emite ningún preámbulo o ha permanecido en silencio durante unos 20 segundos (el encabezado de Telegram actualmente solo usa el preámbulo):

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

La narración auxiliar está habilitada 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 deshabilitar por completo el enrutamiento auxiliar. Las líneas de herramientas siguen acumulándose debajo y reaparecen si ambas fuentes de estado se detienen. Las ediciones del borrador siguen esperando el control de actividad normal y un cambio de texto real, lo que evita parpadeos en turnos rápidos y reduce la cantidad de ediciones en canales con mucha actividad. Establezca narration: false para deshabilitar solo el texto de relleno del modelo auxiliar; los encabezados de preámbulo del modelo permanecen habilitados:

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

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

Límites de líneas

Limitar 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 el reajuste de las burbujas de chat mientras se edita el borrador, y OpenClaw trunca las líneas largas para que las ediciones repetidas del borrador no cambien el ajuste de línea con 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 centrales para que el sufijo permanezca visible.

Ajustar 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, de modo que los clientes que no puedan representar la estructura enriquecida sigan mostrando el texto de progreso compacto.

Ocultar líneas de herramientas/tareas

Mantener el único borrador de progreso, pero ocultar 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 en silencio hasta la respuesta final, excepto por la etiqueta si hay una configurada.

Comportamiento del canal

Los canales que no admiten una edición segura recurren a indicadores de escritura o a la entrega exclusiva de la respuesta final. Consulte Transmisión 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 acuse de actividad -# añadido (por ejemplo, -# 🧠 2 thoughts · 🛠️ 5 tool calls · ⏱️ 12s), y el borrador de estado se elimina una vez entregada la respuesta. Los canales con mucha actividad no conservan ningún registro huérfano de herramientas encima de la respuesta; las respuestas finales con errores conservan el borrador como registro visible del turno fallido.
• Si el borrador puede convertirse de forma segura en la respuesta final (modos partial/block), OpenClaw lo edita directamente.
• Si el canal utiliza transmisión nativa del progreso, OpenClaw finaliza ese flujo cuando el transporte nativo acepta el texto final.
• De lo contrario (contenido multimedia, una solicitud de aprobación, un destino de respuesta explícito, demasiados fragmentos o un fallo de edición o 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 una respuesta al hilo equivocado o sobrescribir un borrador con una carga 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 gestionó el mensaje. Algunas rutas de grupos 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 las herramientas.

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

Esta es la alternativa de seguridad descrita en Finalización. Puede ocurrir con respuestas multimedia, respuestas largas, destinos de respuesta explícitos, borradores antiguos de Telegram, destinos de hilo ausentes en Slack, mensajes de vista previa eliminados o errores al finalizar el flujo nativo.

Sigo viendo mensajes de progreso independientes.

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

Teams se comporta de forma diferente a Discord o Telegram.

Microsoft Teams utiliza un flujo nativo en los chats personales en lugar del transporte genérico de vista previa mediante envío y edición, y asigna streaming.mode: "block" a la entrega por bloques de Teams porque no tiene un modo de bloques de vista previa del borrador como Discord y Telegram.

Relacionado

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