> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# `openclaw tasks`

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

Consulte [Tarefas em segundo plano](/pt-BR/automation/tasks) para ver o ciclo de vida e o modelo de entrega.

## Uso

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 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`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks list [--runtime <name>] [--status <name>] [--json]
```

Lista as tarefas em segundo plano rastreadas, da mais recente para a mais antiga.

### `show`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks show <lookup> [--json]
```

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

### `notify`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks notify <lookup> <done_only|state_changes|silent>
```

Altera a política de notificação de uma tarefa em execução.

### `cancel`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks cancel <lookup>
```

Cancela uma tarefa em segundo plano em execução.

### `audit`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]
```

Expõe registros de tarefas e de Task Flow obsoletos, perdidos, com falha de entrega ou inconsistentes de outra forma. Tarefas perdidas retidas até `cleanupAfter` são avisos; tarefas perdidas expiradas ou sem carimbo são erros.

### `maintenance`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tasks maintenance [--apply] [--json]
```

Pré-visualiza ou aplica reconciliação de tarefas e de Task Flow, carimbo de limpeza, remoção,
e limpeza de registro de sessões obsoletas de execuções Cron.
Para tarefas Cron, a reconciliação usa logs de execução/estado de jobs 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 runtime em memória do Gateway desapareceu. A auditoria offline da CLI
não é autoritativa para o conjunto de jobs ativos de Cron local ao processo do Gateway. Tarefas da CLI
com um ID de execução/ID de origem são marcadas como `lost` quando seu contexto de execução ativo do Gateway
desaparece, 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 jobs Cron em execução no momento e deixando
linhas de sessão não Cron intocadas.

### `flow`

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 de Task Flow sob o ledger de tarefas.

## Relacionados

* [Referência da CLI](/pt-BR/cli)
* [Tarefas em segundo plano](/pt-BR/automation/tasks)