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

1.9 KiB

summary, read_when, title
summary read_when title
Redirect: flow commands live under `openclaw tasks flow`
You encounter `openclaw flows` in older docs or release notes
You want a quick TaskFlow inspection reference
Flows (redirect)

openclaw tasks flow

There is no top-level openclaw flows command. Durable TaskFlow inspection lives under openclaw tasks flow.

Subcommands

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

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. For the parent tasks command, see tasks CLI reference.