Files
moltbot/docs/cli/flows.md

53 lines
2.0 KiB
Markdown

---
summary: "Redirect: flow commands live under `openclaw tasks flow`"
read_when:
- You encounter `openclaw flows` in older docs or release notes
- You want a quick TaskFlow inspection reference
title: "Flows (redirect)"
---
# `openclaw tasks flow`
There is no top-level `openclaw flows` command. Durable TaskFlow inspection lives under `openclaw tasks flow`.
## Subcommands
```bash
openclaw tasks flow list [--json] [--status <name>]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
```
| Subcommand | Description | Arguments / options |
| ---------- | -------------------------- | ------------------------------------------------------------------------------------- |
| `list` | List tracked TaskFlows. | `--json` machine-readable output; `--status <name>` filter (see status values below). |
| `show` | Show one TaskFlow. | `<lookup>` flow id or owner key; `--json` machine-readable output. |
| `cancel` | Cancel a running TaskFlow. | `<lookup>` flow id or owner key. |
`<lookup>` accepts either a flow id (returned by `list` / `show`) or the flow's owner key (the stable identifier the owning subsystem uses to track the flow).
### Status filter values
`--status` on `list` accepts one of:
`queued`, `running`, `waiting`, `blocked`, `succeeded`, `failed`, `cancelled`, `lost`
## Examples
```bash
openclaw tasks flow list
openclaw tasks flow list --status running
openclaw tasks flow list --json
openclaw tasks flow show flow_abc123
openclaw tasks flow show flow_abc123 --json
openclaw tasks flow cancel flow_abc123
```
For full TaskFlow concepts and authoring see [TaskFlow](/automation/taskflow). For the parent `tasks` command see [tasks CLI reference](/cli/tasks).
## Related
- [CLI reference](/cli)
- [Automation](/automation)
- [TaskFlow](/automation/taskflow)