CLI commands

`openclaw tasks`

Inspecciona tareas en segundo plano duraderas y el estado de Task Flow. Sin subcomando, openclaw tasks equivale a openclaw tasks list.

Consulta Tareas en segundo plano para ver el ciclo de vida y el modelo de entrega.

Uso

bash

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

--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`

bash

openclaw tasks list [--runtime <name>] [--status <name>] [--json]

Enumera las tareas en segundo plano rastreadas, de la más reciente a la más antigua.

`show`

bash

openclaw tasks show <lookup> [--json]

Muestra una tarea por ID de tarea, ID de ejecución o clave de sesión.

`notify`

bash

openclaw tasks notify <lookup> <done_only|state_changes|silent>

Cambia la política de notificaciones de una tarea en ejecución.

`cancel`

bash

openclaw tasks cancel <lookup>

Cancela una tarea en segundo plano en ejecución.

`audit`

bash

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

Expone registros de tareas y Task Flow obsoletos, perdidos, con entrega fallida o incoherentes de otro modo. Las tareas perdidas retenidas hasta cleanupAfter son advertencias; las tareas perdidas vencidas o sin marca de tiempo son errores.

`maintenance`

bash

openclaw tasks maintenance [--apply] [--json]

Previsualiza o aplica la reconciliación de tareas y Task Flow, el marcado de limpieza, la poda y la limpieza del registro de sesiones de ejecuciones cron obsoletas. Para las tareas cron, la reconciliación usa registros de ejecución persistidos/estado del trabajo antes de marcar una tarea activa antigua como lost, por lo que las ejecuciones cron completadas no se convierten en falsos errores de auditoría solo porque el estado en memoria del runtime de Gateway ya no exista. La auditoría de CLI sin conexión no es autoritativa para el conjunto de trabajos cron activos local al proceso de Gateway. Las tareas de CLI con un ID de ejecución/ID de origen se marcan como lost cuando su contexto de ejecución vivo de Gateway desaparece, incluso si queda una fila antigua de sesión hija. Cuando se aplica, el mantenimiento también poda las filas del registro de sesiones cron:<jobId>:run:<uuid> con más de 7 días de antigüedad mientras conserva los trabajos cron actualmente en ejecución y deja intactas las filas de sesiones que no son cron.

`flow`

bash

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 bajo el libro mayor de tareas.

Relacionado

Was this useful?