Task Flow es el sustrato de orquestación de flujos que se sitúa por encima de las tareas en segundo plano. Gestiona flujos duraderos de varios pasos con su propio estado, seguimiento de revisiones y semántica de sincronización, mientras que las tareas individuales siguen siendo la unidad de trabajo desacoplado.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Cuándo usar Task Flow
Usa Task Flow cuando el trabajo abarque varios pasos secuenciales o ramificados y necesites un seguimiento duradero del progreso entre reinicios del Gateway. Para operaciones individuales en segundo plano, una tarea simple es suficiente.| Escenario | Uso |
|---|---|
| Trabajo único en segundo plano | Tarea simple |
| Canalización de varios pasos (A, luego B, luego C) | Task Flow (gestionado) |
| Observar tareas creadas externamente | Task Flow (replicado) |
| Recordatorio de una sola vez | Trabajo Cron |
Patrón de flujo de trabajo programado fiable
Para flujos de trabajo recurrentes como informes de inteligencia de mercado, trata la programación, la orquestación y las comprobaciones de fiabilidad como capas separadas:- Usa Tareas programadas para la temporización.
- Usa una sesión de cron persistente cuando el flujo de trabajo deba basarse en contexto previo.
- Usa Lobster para pasos deterministas, puertas de aprobación y tokens de reanudación.
- Usa Task Flow para hacer seguimiento de la ejecución de varios pasos a través de tareas secundarias, esperas, reintentos y reinicios del Gateway.
session:<id> en lugar de isolated cuando el flujo de trabajo recurrente necesite historial deliberado, resúmenes de ejecuciones anteriores o contexto permanente. Usa isolated cuando cada ejecución deba empezar desde cero y todo el estado requerido sea explícito en el flujo de trabajo.
Dentro del flujo de trabajo, coloca las comprobaciones de fiabilidad antes del paso de resumen del LLM:
- Disponibilidad del navegador y elección de perfil, por ejemplo
openclawpara estado gestionado ousercuando se requiere una sesión de Chrome con inicio de sesión. Consulta Navegador. - Credenciales de API y cuota para cada fuente.
- Alcanzabilidad de red de los endpoints requeridos.
- Herramientas requeridas habilitadas para el agente, como
lobster,browseryllm-task. - Destino de fallos configurado para cron, de modo que los fallos previos sean visibles. Consulta Tareas programadas.
sourceUrl, retrievedAt y asOf en su salida. Usa LLM Task cuando necesites un paso de modelo validado por esquema dentro del flujo de trabajo.
Para flujos de trabajo reutilizables de equipo o comunidad, empaqueta la CLI, los archivos .lobster y cualquier nota de configuración como una skill o Plugin y publícalo a través de ClawHub. Mantén las barreras de seguridad específicas del flujo de trabajo en ese paquete salvo que a la API del Plugin le falte una capacidad genérica necesaria.
Modos de sincronización
Modo gestionado
Task Flow posee el ciclo de vida de extremo a extremo. Crea tareas como pasos del flujo, las impulsa hasta completarlas y avanza el estado del flujo automáticamente. Ejemplo: un flujo de informe semanal que (1) recopila datos, (2) genera el informe y (3) lo entrega. Task Flow crea cada paso como una tarea en segundo plano, espera a que se complete y luego pasa al siguiente paso.Modo replicado
Task Flow observa tareas creadas externamente y mantiene el estado del flujo sincronizado sin asumir la propiedad de la creación de tareas. Esto resulta útil cuando las tareas se originan en trabajos cron, comandos de CLI u otras fuentes, y quieres una vista unificada de su progreso como flujo. Ejemplo: tres trabajos cron independientes que juntos forman una rutina de “operaciones matutinas”. Un flujo replicado hace seguimiento de su progreso colectivo sin controlar cuándo ni cómo se ejecutan.Estado duradero y seguimiento de revisiones
Cada flujo conserva su propio estado y hace seguimiento de las revisiones para que el progreso sobreviva a los reinicios del Gateway. El seguimiento de revisiones permite detectar conflictos cuando varias fuentes intentan avanzar el mismo flujo de forma concurrente. El registro de flujos usa SQLite con mantenimiento acotado del registro de escritura anticipada, incluidos puntos de control periódicos y al apagarse, de modo que los gateways de larga duración no retengan archivos auxiliaresregistry.sqlite-wal sin límite.
Comportamiento de cancelación
openclaw tasks flow cancel establece una intención de cancelación persistente en el flujo. Las tareas activas dentro del flujo se cancelan y no se inician pasos nuevos. La intención de cancelación persiste entre reinicios, por lo que un flujo cancelado permanece cancelado incluso si el Gateway se reinicia antes de que todas las tareas secundarias hayan terminado.
Comandos de CLI
| Comando | Descripción |
|---|---|
openclaw tasks flow list | Muestra los flujos registrados con estado y modo de sincronización |
openclaw tasks flow show <id> | Inspecciona un flujo por id de flujo o clave de búsqueda |
openclaw tasks flow cancel <id> | Cancela un flujo en ejecución y sus tareas activas |
Cómo se relacionan los flujos con las tareas
Los flujos coordinan tareas, no las sustituyen. Un solo flujo puede ejecutar varias tareas en segundo plano durante su vida útil. Usaopenclaw tasks para inspeccionar registros de tareas individuales y openclaw tasks flow para inspeccionar el flujo orquestador.
Relacionado
- Tareas en segundo plano — el registro de trabajo desacoplado que coordinan los flujos
- CLI: tareas — referencia de comandos de CLI para
openclaw tasks flow - Resumen de automatización — todos los mecanismos de automatización de un vistazo
- Trabajos Cron — trabajos programados que pueden alimentar flujos