Flujo de tareas

Task Flow es el sustrato de orquestación de flujos que se sitúa sobre 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.

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 únicas en segundo plano, basta con una tarea simple.

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:

1. Usa Tareas programadas para el tiempo de ejecución.
2. Usa una sesión cron persistente cuando el flujo de trabajo deba basarse en contexto previo.
3. Usa Lobster para pasos deterministas, puertas de aprobación y tokens de reanudación.
4. Usa Task Flow para realizar el seguimiento de la ejecución de varios pasos a través de tareas secundarias, esperas, reintentos y reinicios del gateway.

Ejemplo de forma de cron:

openclaw cron add \  --name "Market intelligence brief" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \  --announce \  --channel slack \  --to "channel:C1234567890"

Usa 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 esté explícito en el flujo de trabajo.

Dentro del flujo de trabajo, coloca las comprobaciones de fiabilidad antes del paso de resumen con el LLM:

name: market-intel-briefsteps:  - id: preflight    command: market-intel check --json  - id: collect    command: market-intel collect --json    stdin: $preflight.json  - id: summarize    command: market-intel summarize --json    stdin: $collect.json  - id: approve    command: market-intel deliver --preview    stdin: $summarize.json    approval: required  - id: deliver    command: market-intel deliver --execute    stdin: $summarize.json    condition: $approve.approved

Comprobaciones de preflight recomendadas:

• Disponibilidad del navegador y elección del perfil, por ejemplo openclaw para estado gestionado o user cuando se requiere una sesión de Chrome con sesión 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, browser y llm-task.
• Destino de fallo configurado para cron de modo que los fallos de preflight sean visibles. Consulta Tareas programadas.

Campos de procedencia de datos recomendados para cada elemento recopilado:

{  "sourceUrl": "https://example.com/report",  "retrievedAt": "2026-04-24T12:00:00Z",  "asOf": "2026-04-24",  "title": "Example report",  "content": "..."}

Haz que el flujo de trabajo rechace o marque como obsoletos los elementos antes de la generación del resumen. El paso del LLM debe recibir solo JSON estructurado y se le debe pedir que preserve 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 protección 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 principio a fin. Crea tareas como pasos del flujo, las lleva 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.

Flow: weekly-report  Step 1: gather-data     → task created → succeeded  Step 2: generate-report → task created → succeeded  Step 3: deliver         → task created → running

Modo reflejado

Task Flow observa tareas creadas externamente y mantiene el estado del flujo sincronizado sin asumir la creación de tareas. Esto es ú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 reflejado realiza el seguimiento de su progreso colectivo sin controlar cuándo ni cómo se ejecutan.

Estado duradero y seguimiento de revisiones

Cada flujo persiste su propio estado y realiza un 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 simultáneamente. El registro de flujos usa SQLite con mantenimiento acotado del registro de escritura anticipada, incluidos puntos de control periódicos y al apagar, para que los gateways de larga duración no conserven archivos auxiliares registry.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 nuevos pasos. 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

# List active and recent flowsopenclaw tasks flow list # Show details for a specific flowopenclaw tasks flow show <lookup> # Cancel a running flow and its active tasksopenclaw tasks flow cancel <lookup>

Cómo se relacionan los flujos con las tareas

Los flujos coordinan tareas, no las sustituyen. Un solo flujo puede controlar varias tareas en segundo plano durante su vida útil. Usa openclaw 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: 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