Automation and tasks

Flujo de tareas

El flujo de tareas 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 el flujo de tareas

Usa el flujo de tareas 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 normal.

Escenario	Uso
Trabajo único en segundo plano	Tarea normal
Canalización de varios pasos (A luego B luego C)	Flujo de tareas (gestionado)
Observar tareas creadas externamente	Flujo de tareas (replicado)
Recordatorio de una sola vez	Trabajo de Cron

Patrón fiable de flujo de trabajo programado

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 el flujo de tareas para hacer seguimiento de la ejecución de varios pasos entre tareas hijas, esperas, reintentos y reinicios del gateway.

Forma de Cron de ejemplo:

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 previas o contexto permanente. Usa isolated cuando cada ejecución deba empezar desde cero y todo el estado necesario esté explícito en el flujo de trabajo.

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

name: market-intel-brief
steps:
  - 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 previas 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 inicio de sesión. 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 fallos configurado para Cron para que los fallos de comprobación previa sean visibles. Consulta Tareas programadas.

Campos recomendados de procedencia de datos 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 del resumen. El paso del LLM debe recibir solo JSON estructurado y se le debe pedir que conserve sourceUrl, retrievedAt y asOf en su salida. Usa Tarea LLM 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 skill o plugin, y publícalo mediante ClawHub. Mantén las protecciones 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

El flujo de tareas controla el ciclo de vida de extremo a extremo. Crea tareas como pasos del flujo, las conduce 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. El flujo de tareas crea cada paso como una tarea en segundo plano, espera a que finalice 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 replicado

El flujo de tareas observa tareas creadas externamente y mantiene el estado del flujo sincronizado sin asumir la propiedad de la creación de tareas. Esto es útil cuando las tareas se originan desde trabajos de Cron, comandos de CLI u otras fuentes y quieres una vista unificada de su progreso como flujo.

Ejemplo: tres trabajos de Cron independientes que juntos forman una rutina de "operaciones matutinas". Un flujo replicado rastrea 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 write-ahead log, incluidos puntos de control periódicos y al apagar, para que los gateways de larga ejecución no conserven archivos complementarios 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 pasos nuevos. La intención de cancelación persiste entre reinicios, por lo que un flujo cancelado permanece cancelado aunque el gateway se reinicie antes de que todas las tareas hijas hayan terminado.

Comandos de CLI

# List active and recent flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
openclaw tasks flow cancel <lookup>

Comando	Descripción
`openclaw tasks flow list`	Muestra los flujos rastreados 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 reemplazan. Un único flujo puede dirigir 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 libro de 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 de Cron — trabajos programados que pueden alimentar flujos

# Cuándo usar el flujo de tareas

# Patrón fiable de flujo de trabajo programado

# Modos de sincronización

# Modo gestionado

# Modo replicado

# Estado duradero y seguimiento de revisiones

# Comportamiento de cancelación

# Comandos de CLI

# Cómo se relacionan los flujos con las tareas

# Relacionado