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.
Consulte Tareas en segundo plano para conocer el ciclo de vida y el modelo
de entrega, y su sección tasks audit para obtener 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 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 ID de tarea, ID 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]Expone registros de tareas y Task Flow obsoletos, perdidos, con errores de entrega
o que presentan otras incoherencias. Las tareas perdidas que se conservan hasta cleanupAfter son advertencias;
las tareas perdidas caducadas o sin marca 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). Consulte
Tareas en segundo plano para obtener detalles sobre la gravedad y el desencadenante de cada
código.
maintenance
openclaw tasks maintenance [--apply] [--json]Previsualiza o aplica la conciliación de tareas y Task Flow, el marcado de 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 del trabajo 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 el estado del entorno de ejecución en memoria del Gateway haya desaparecido.
La auditoría sin conexión de la CLI no es una fuente autoritativa para el conjunto de trabajos de Cron activos
local al proceso del Gateway. Las tareas de la CLI con un ID de ejecución o un ID de origen se marcan como lost cuando
su contexto de ejecución activo del Gateway ha desaparecido, aunque aún quede una fila antigua de
sesión secundaria.
Cuando se aplica, el mantenimiento también depura las filas del registro de sesiones cron:<jobId>:run:<uuid>
con más de 7 días de antigüedad, al tiempo que conserva los trabajos de Cron en ejecución
y no modifica las filas 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 libro mayor de tareas.
flow list --status acepta queued, running, waiting, blocked,
succeeded, failed, cancelled o lost.
