`openclaw tasks`

Inspecione tarefas em segundo plano duráveis e o estado do Task Flow. Sem subcomando, openclaw tasks é equivalente a openclaw tasks list.

Veja Tarefas em segundo plano para o ciclo de vida e o modelo de entrega.

# Uso

openclaw tasks
openclaw tasks list
openclaw tasks list --runtime acp
openclaw tasks list --status running
openclaw tasks show <lookup>
openclaw tasks notify <lookup> state_changes
openclaw tasks cancel <lookup>
openclaw tasks audit
openclaw tasks maintenance
openclaw tasks maintenance --apply
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

# Opções raiz

• --json: gera 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, das mais novas para as mais antigas.

# show

openclaw tasks show <lookup> [--json]

Mostra uma tarefa por ID da tarefa, ID da execução ou chave de sessão.

# notify

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

Altera a política de notificação 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]

Mostra registros de tarefa e de estado do Task Flow obsoletos, perdidos, com falha de entrega ou de outra forma inconsistentes. Tarefas perdidas mantidas até cleanupAfter são avisos; tarefas perdidas expiradas ou sem marcação são erros.

# maintenance

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

Visualiza ou aplica reconciliação, marcação de limpeza e remoção de tarefas e do Task Flow. Para tarefas cron, a reconciliação usa logs persistidos de execução/estado do job antes de marcar uma tarefa ativa antiga como lost, para que execuções cron concluídas não virem falsos erros de auditoria apenas porque o estado de runtime em memória do Gateway não existe mais. A auditoria offline da CLI não é autoritativa para o conjunto de jobs cron ativos local ao processo do Gateway.

# 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 Task Flow no registro de tarefas.

# Relacionados

• Referência da CLI
• Tarefas em segundo plano