Files
openclaw-openclaw/docs/cli/flows.md
Peter Steinberger f7d7148cf0 docs: rewrite published docs grounded in current source (#100142)
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green.

Closes #100141
2026-07-05 00:32:47 -04:00

51 lines
1.9 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 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)