CLI commands
`openclaw tasks`
Inspecciona las tareas duraderas en segundo plano y el estado de Task Flow. Sin un subcomando,
openclaw tasks equivale a openclaw tasks list.
Consulta Tareas en segundo plano para conocer el ciclo de vida y el modelo
de entrega, y su sección tasks audit para ver las descripciones completas de los hallazgos.
Uso
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>Opciones raíz
| Indicador | Descripción |
|---|---|
--json |
Genera la salida en formato JSON. |
--runtime <name> |
Filtra por tipo: subagent, acp, cron o cli. |
--status <name> |
Filtra por estado: queued, running, succeeded, failed, timed_out, cancelled o lost. |
Subcomandos
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]Enumera las tareas en segundo plano registradas, comenzando por las más recientes.
show
openclaw tasks show <lookup> [--json]Muestra una tarea por su identificador de tarea, identificador de ejecución o clave de sesión.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>Cambia la política de notificaciones de una tarea en ejecución.
cancel
openclaw tasks cancel <lookup>Cancela una tarea en segundo plano en ejecución.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]Muestra registros de tareas y Task Flow obsoletos, perdidos, con errores de entrega
o que presentan otras incoherencias. Las tareas perdidas conservadas hasta cleanupAfter
son advertencias; las tareas perdidas caducadas o sin marca de tiempo son errores.
--code acepta códigos de tareas (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) y códigos de Task
Flow (restore_failed, stale_waiting, stale_blocked,
cancel_stuck, missing_linked_tasks, blocked_task_missing). Consulta
Tareas en segundo plano para obtener información detallada sobre la gravedad
y las condiciones de activación de cada código.
maintenance
openclaw tasks maintenance [--apply] [--json]Previsualiza o aplica la conciliación de tareas y Task Flow, el marcado para limpieza, la depuración y la limpieza del registro de sesiones de ejecuciones de Cron obsoletas.
Para las tareas de Cron, la conciliación utiliza los registros persistentes de ejecución y el estado de los trabajos antes
de marcar una tarea activa antigua como lost, de modo que las ejecuciones de Cron completadas no se conviertan
en falsos errores de auditoría solo porque haya desaparecido el estado de ejecución en memoria del Gateway.
La auditoría sin conexión de la CLI no es la fuente autoritativa para el conjunto de trabajos activos de Cron
local al proceso del Gateway. Las tareas de la CLI con un identificador de ejecución o de origen se marcan como lost cuando
desaparece su contexto de ejecución activo en el Gateway, aunque permanezca un registro antiguo de sesión secundaria.
Cuando se aplica, el mantenimiento también depura los registros de sesiones
cron:<jobId>:run:<uuid> con más de 7 días de antigüedad, al tiempo que conserva los trabajos de Cron
actualmente en ejecución y no modifica los registros de sesiones que no pertenecen a Cron.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>Inspecciona o cancela el estado duradero de Task Flow en el registro de tareas.
flow list --status acepta queued, running, waiting, blocked,
succeeded, failed, cancelled o lost.
