Cuándo usar Task Flow
| Escenario | Uso |
|---|---|
| Trabajo único en segundo plano | Tarea simple |
| Pipeline de varios pasos impulsado por código de plugin | Task Flow (administrado) |
| Creación de ACP desacoplado o subagente | Task Flow (reflejado, creado automáticamente) |
| Recordatorio de una sola ejecución | Trabajo Cron |
Modos de sincronización
Modo administrado
Un flujo administrado tiene un controlador: código de plugin que crea el flujo mediante la API de Task Flow del runtime del plugin con un objetivo y un id de controlador obligatorio, y luego lo impulsa explícitamente.- Cada paso se ejecuta como una tarea en segundo plano creada bajo el flujo; la clave de propietario del flujo y el origen del solicitante se transfieren a las tareas hijas.
- El controlador avanza el flujo entre
running,waitingy estados terminales, y almacena estado de paso JSON arbitrario en el registro del flujo. - Cada mutación pasa la revisión esperada del flujo. Una escritura obsoleta se rechaza como conflicto de revisión en lugar de sobrescribir un estado más nuevo.
- Una vez solicitada la cancelación, se rechazan nuevas tareas hijas, y el flujo finaliza como
cancelledcuando ninguna tarea hija permanece activa.
Modo reflejado
OpenClaw crea automáticamente un flujo reflejado de una tarea cuando se inicia una ejecución desacoplada de ACP o subagente (tareas con alcance de sesión y finalización entregable). El registro del flujo refleja su única tarea subyacente - estado, objetivo y tiempos - para que las creaciones desacopladas obtengan un identificador de flujo estable para superficies de estado y reintento sin controlador. Los flujos reflejados muestran el modo de sincronizacióntask_mirrored en la CLI.
Estados de flujo
| Estado | Significado |
|---|---|
queued | Creado, aún sin progresar |
running | El flujo está progresando activamente |
waiting | El flujo administrado está estacionado en metadatos de espera (temporizador, evento externo) |
blocked | Un paso terminó sin un resultado utilizable; blockedTaskId/resumen indican cuál |
succeeded | Completado correctamente |
failed | Completado con un error |
cancelled | Cancelación solicitada y todas las tareas hijas resueltas |
lost | El flujo perdió su estado subyacente autoritativo |
Estado duradero y seguimiento de revisiones
Los registros de flujo persisten en la base de datos de estado SQLite compartida (~/.openclaw/state/openclaw.sqlite, tabla flow_runs) junto con los registros de tareas, por lo que el progreso sobrevive a los reinicios del gateway. Cada escritura incrementa la revision del flujo; los escritores concurrentes que pasan una revisión esperada obsoleta reciben un conflicto y deben volver a leer. El crecimiento de WAL está limitado por el autocheckpointing de SQLite más checkpoints pasivos periódicos, con checkpoints de truncado al apagar. El sidecar heredado flows/registry.sqlite de instalaciones anteriores se importa mediante openclaw doctor.
Comportamiento de cancelación
openclaw tasks flow cancel establece una intención de cancelación persistente en el flujo, cancela sus tareas hijas activas y rechaza nuevas tareas hijas administradas. Una vez que ninguna tarea hija permanece activa, el flujo finaliza como cancelled: de inmediato o mediante el barrido de mantenimiento si las hijas tardan más en resolverse. La intención se conserva, por lo que un flujo cancelado permanece cancelado incluso si el gateway se reinicia antes de que todas las tareas hijas hayan terminado.
Comandos de CLI
| Comando | Descripción |
|---|---|
openclaw tasks flow list | Flujos rastreados con modo de sincronización, estado, revisión, controlador y conteos de tareas |
openclaw tasks flow show <id> | Inspecciona un flujo por id de flujo o clave de propietario, incluidas las tareas vinculadas |
openclaw tasks flow cancel <id> | Cancela un flujo en ejecución y sus tareas activas |
openclaw tasks audit (hallazgos de flujos obsoletos o rotos) y openclaw tasks maintenance (finaliza cancelaciones atascadas, elimina flujos terminales después de 7 días).
Patrón de workflow programado confiable
Para workflows recurrentes como informes de inteligencia de mercado, trata la programación, la orquestación y las comprobaciones de confiabilidad como capas separadas:- Usa Tareas programadas para la temporización.
- Usa una sesión cron persistente cuando el workflow deba basarse en contexto previo.
- Usa Lobster para pasos deterministas, puertas de aprobación y tokens de reanudación.
- Usa Task Flow para rastrear la ejecución de varios pasos a través de tareas hijas, esperas, reintentos y reinicios del gateway.
--session session:<id> en lugar de isolated cuando el workflow 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 workflow.
Dentro del workflow, coloca las comprobaciones de confiabilidad antes del paso de resumen del LLM:
- Disponibilidad del navegador y elección de perfil, por ejemplo
openclawpara estado administrado ousercuando se requiere una sesión de Chrome iniciada. Consulta Navegador. - Credenciales de API y cuota para cada fuente.
- Accesibilidad de red para los endpoints requeridos.
- Herramientas requeridas habilitadas para el agente, como
lobster,browseryllm-task. - Destino de fallo configurado para cron para que los fallos de preflight 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 workflow.
Para workflows 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 mediante ClawHub. Mantén las barandillas específicas del workflow en ese paquete a menos que a la API del plugin le falte una capacidad genérica necesaria.
Cómo se relacionan los flujos con las tareas
Los flujos coordinan tareas, no las reemplazan. Un solo flujo puede impulsar 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 libro mayor de trabajo desacoplado que coordinan los flujos
- CLI: tasks - 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