Messages and delivery

Borradores de progreso

Los borradores de progreso hacen que los turnos de agente de larga duración se sientan vivos en el chat sin convertir la conversación en una pila de respuestas de estado temporales.

Cuando los borradores de progreso están habilitados, OpenClaw crea un único mensaje visible de trabajo en curso solo después de que el turno demuestra que está realizando trabajo real, lo actualiza mientras el agente lee, planifica, llama herramientas o espera aprobación, y luego convierte ese borrador en la respuesta final cuando el canal puede hacerlo de forma segura.

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

Usa borradores de progreso cuando quieras un único mensaje de estado ordenado durante trabajos con muchas herramientas y la respuesta final cuando el turno termine.

Inicio rápido

Habilita los borradores de progreso por canal con streaming.mode: "progress":

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

Eso suele ser suficiente. OpenClaw elegirá una etiqueta automática de una palabra, esperará hasta que el trabajo dure al menos cinco segundos o emita un segundo evento de trabajo, añadirá líneas de progreso compactas mientras ocurre trabajo útil y suprimirá la charla de progreso independiente duplicada para ese turno.

Qué ven los usuarios

Un borrador de progreso tiene dos partes:

Parte	Propósito
Etiqueta	Un título corto como `Thinking...` o `Shelling...`.
Líneas de progreso	Actualizaciones de ejecución compactas que usan las mismas etiquetas e iconos de herramientas que la salida detallada.

La etiqueta aparece después de que el agente inicia trabajo significativo y permanece ocupado durante cinco segundos o emite un segundo evento de trabajo. Las respuestas solo de texto sin formato no muestran un borrador de progreso. Las líneas de progreso se añaden solo cuando el agente emite actualizaciones de trabajo útiles, por ejemplo 🛠️ Exec, 🔎 Web Search o ✍️ Write: to /tmp/file. De forma predeterminada usan el mismo modo de explicación compacto que /verbose; configura agents.defaults.toolProgressDetail: "raw" al depurar y cuando también quieras que se adjunten comandos/detalles sin procesar. La respuesta final reemplaza el borrador cuando es posible; de lo contrario, OpenClaw envía la respuesta final normalmente y limpia o deja de actualizar el borrador según el transporte del canal.

Elegir un modo

channels.<channel>.streaming.mode controla el comportamiento visible en curso:

Modo	Ideal para	Lo que aparece en el chat
`off`	Canales silenciosos	Solo la respuesta final.
`partial`	Ver aparecer el texto de la respuesta	Un borrador editado con el texto de respuesta más reciente.
`block`	Fragmentos más grandes de vista previa de respuesta	Una vista previa actualizada o añadida en fragmentos más grandes.
`progress`	Turnos con muchas herramientas o de larga duración	Un borrador de estado y luego la respuesta final.

Elige progress cuando a los usuarios les importe más "qué está ocurriendo" que ver el texto de la respuesta transmitirse token por token.

Elige partial cuando la respuesta en sí sea la señal de progreso.

Elige block cuando quieras actualizaciones de borrador de vista previa en fragmentos de texto más grandes. En Discord y Telegram, streaming.mode: "block" sigue siendo streaming de vista previa, no entrega normal por bloques. Usa streaming.block.enabled o el legado blockStreaming cuando quieras respuestas normales por bloques.

Configurar etiquetas

Las etiquetas de progreso se encuentran en channels.<channel>.streaming.progress.

La etiqueta predeterminada es auto, que elige del conjunto integrado de etiquetas de OpenClaw de una sola palabra con puntos suspensivos:

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

Usa una etiqueta fija:

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

Usa tu propio conjunto de etiquetas automáticas:

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

Oculta la etiqueta y muestra solo las líneas de progreso:

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

Controlar las líneas de progreso

Las líneas de progreso están habilitadas de forma predeterminada en el modo 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 actividad similar del agente.

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 los borradores estables con etiquetas concisas como 🛠️ Exec: check JS syntax for /tmp/app.js. "raw" adjunta el comando/detalle subyacente cuando está disponible, lo que resulta útil durante la depuración pero genera más ruido en el chat.

Por ejemplo, el mismo comando aparece de forma diferente según el modo de detalle:

Modo	Línea de progreso
`explain`	`🛠️ Exec: check JS syntax for /tmp/app.js`
`raw`	`🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js`

Limita cuántas líneas permanecen visibles:

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

Las líneas de progreso se compactan automáticamente para reducir el reajuste del globo de chat mientras se edita el borrador.

OpenClaw trunca de forma predeterminada las líneas de progreso largas para que las ediciones repetidas del borrador no se ajusten de manera diferente en cada actualización. El prefijo sigue siendo legible y los detalles largos, como rutas o comandos sin procesar, se acortan con puntos suspensivos.

Slack puede representar líneas de progreso como campos estructurados de Block Kit en lugar de un único cuerpo de texto:

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

La representación enriquecida conserva la misma alternativa de texto sin formato para que los canales y clientes que no admiten la forma más rica puedan seguir mostrando el texto de progreso compacto.

Conserva el único borrador de progreso pero oculta las líneas de herramientas y tareas:

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

Con toolProgress: false, OpenClaw sigue suprimiendo los mensajes de progreso de herramientas independientes más antiguos para ese turno. El canal permanece visualmente silencioso hasta la respuesta final, salvo por la etiqueta si hay una configurada.

Comportamiento del canal

Cada canal usa el transporte más limpio que admite:

Canal	Transporte de progreso	Notas
Discord	Envía un mensaje y luego lo edita.	El texto final se edita en el mismo lugar cuando cabe en un mensaje de vista previa seguro.
Matrix	Envía un evento y luego lo edita.	La configuración de streaming a nivel de cuenta controla los borradores a nivel de cuenta.
Microsoft Teams	Stream nativo de Teams en chats personales.	`streaming.mode: "block"` se asigna a la entrega por bloques de Teams.
Slack	Stream nativo o publicación de borrador editable.	La disponibilidad del hilo afecta si se puede usar streaming nativo.
Telegram	Envía un mensaje y luego lo edita.	Los borradores visibles antiguos pueden reemplazarse para que las marcas de tiempo finales sigan siendo útiles.
Mattermost	Publicación de borrador editable.	La actividad de herramientas se integra en la misma publicación de estilo borrador.

Los canales sin soporte de edición seguro suelen recurrir a indicadores de escritura o entrega solo final.

Finalización

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

Si el borrador puede convertirse de forma segura en la respuesta final, OpenClaw lo edita en el mismo lugar.
Si el canal usa streaming de progreso nativo, OpenClaw finaliza ese stream cuando el transporte nativo acepta el texto final.
Si la respuesta final tiene contenido multimedia, una solicitud de aprobación, un destino de respuesta explícito, demasiados fragmentos o un envío/edición fallido, OpenClaw envía la respuesta final mediante la ruta normal de entrega del canal.

La ruta alternativa es intencional. Es mejor enviar una respuesta final nueva que perder texto, encadenar mal una respuesta 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.

Comprueba que channels.<channel>.streaming.mode esté configurado en progress para la cuenta o el canal que gestionó el mensaje. Algunas rutas de grupo o de respuesta con cita pueden deshabilitar las vistas previas de borrador para 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 conserva el comportamiento de un único borrador pero oculta las líneas de progreso de herramientas y tareas.

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

Eso es una alternativa de seguridad. 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 finalización fallida de streams nativos.

Sigo viendo mensajes de progreso independientes.

El modo de progreso suprime los mensajes predeterminados de progreso de herramientas independientes cuando hay un borrador activo. Si siguen apareciendo mensajes independientes, verifica que el turno realmente esté usando el modo de progreso y no streaming.mode: "off" o una ruta de canal que no puede crear un borrador para ese mensaje.

Teams se comporta de forma diferente a Discord o Telegram.

Microsoft Teams usa un stream nativo en chats personales en lugar del transporte genérico de vista previa de enviar y editar. Teams también trata streaming.mode: "block" como entrega por bloques de Teams porque no tiene el mismo modo de bloque de vista previa de borrador usado por Discord y Telegram.

Borradores de progreso

Inicio rápido

Qué ven los usuarios

Elegir un modo

Configurar etiquetas

Controlar las líneas de progreso

Comportamiento del canal

Finalización

Solución de problemas

Relacionado

Ask OpenClaw

# Inicio rápido

# Qué ven los usuarios

# Elegir un modo

# Configurar etiquetas

# Controlar las líneas de progreso

# Comportamiento del canal

# Finalización

# Solución de problemas

# Relacionado

Inicio rápido

Qué ven los usuarios

Elegir un modo

Configurar etiquetas

Controlar las líneas de progreso

Comportamiento del canal

Finalización

Solución de problemas

Relacionado