CLI commands
`openclaw tasks`
Inspecione tarefas duráveis em segundo plano e o estado do TaskFlow. Sem um subcomando,
openclaw tasks equivale a openclaw tasks list.
Consulte Tarefas em segundo plano para conhecer o ciclo de vida e o modelo
de entrega, e a seção tasks audit para obter descrições completas das constatações.
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>Opções raiz
| Sinalizador | Descrição |
|---|---|
--json |
Gera a saída em JSON. |
--runtime <name> |
Filtra por tipo: subagent, acp, cron ou cli. |
--status <name> |
Filtra por status: queued, running, succeeded, failed, timed_out, cancelled ou lost. |
Subcomandos
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]Lista as tarefas em segundo plano rastreadas, começando pelas mais recentes.
show
openclaw tasks show <lookup> [--json]Exibe uma tarefa pelo ID da tarefa, ID da execução ou chave da sessão.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>Altera a política de notificações de uma tarefa em execução.
cancel
openclaw tasks cancel <lookup>Cancela uma tarefa em segundo plano em execução.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]Apresenta registros de tarefas e do TaskFlow obsoletos, perdidos, com falha de entrega
ou inconsistentes de alguma outra forma. Tarefas perdidas mantidas até cleanupAfter
são avisos; tarefas perdidas expiradas ou sem marcação são erros.
--code aceita códigos de tarefa (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) e códigos do TaskFlow
(restore_failed, stale_waiting, stale_blocked, cancel_stuck,
missing_linked_tasks, blocked_task_missing). Consulte
Tarefas em segundo plano para obter detalhes sobre a gravidade e o acionador
de cada código.
maintenance
openclaw tasks maintenance [--apply] [--json]Visualiza ou aplica a reconciliação de tarefas e do TaskFlow, a marcação para limpeza, a remoção e a limpeza do registro de sessões de execuções Cron obsoletas.
Para tarefas Cron, a reconciliação usa os logs de execução e o estado dos trabalhos persistidos antes
de marcar uma tarefa ativa antiga como lost, para que execuções Cron concluídas não se tornem
falsos erros de auditoria apenas porque o estado de execução do Gateway em memória não está mais disponível.
A auditoria offline da CLI não é definitiva para o conjunto de trabalhos Cron ativos locais ao processo
do Gateway. Tarefas da CLI com um ID de execução/ID de origem são marcadas como lost quando
o contexto de execução ativo no Gateway não está mais disponível, mesmo que uma linha antiga de sessão filha
permaneça.
Quando aplicada, a manutenção também remove linhas do registro de sessões
cron:<jobId>:run:<uuid> com mais de 7 dias, preservando os trabalhos Cron atualmente em execução
e mantendo inalteradas as linhas de sessões que não sejam Cron.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>Inspeciona ou cancela o estado durável do TaskFlow no registro de tarefas.
flow list --status aceita queued, running, waiting, blocked,
succeeded, failed, cancelled ou lost.
