Skip to content
OpenClaw Docs

Task Flow

This content is not available in your language yet.

Task Flow

Section titled “Task Flow”

Task Flow is the flow orchestration substrate that sits above background tasks. It manages durable multi-step flows with their own state, revision tracking, and sync semantics while individual tasks remain the unit of detached work.

Sync modes

Section titled “Sync modes”

Task Flow supports two sync modes:

  • Managed — Task Flow owns the lifecycle end-to-end, creating and driving tasks as flow steps progress.
  • Mirrored — Task Flow observes externally created tasks and keeps flow state in sync without taking ownership of task creation.

Durable state and revision tracking

Section titled “Durable state and revision tracking”

Each flow persists its own state and tracks revisions so progress survives gateway restarts. Revision tracking enables conflict detection when multiple sources attempt to advance the same flow.

CLI commands

Section titled “CLI commands”
Terminal window
# List active and recent flows
openclaw tasks flow list


# Show details for a specific flow
openclaw tasks flow show <lookup>


# Cancel a running flow
openclaw tasks flow cancel <lookup>
  • openclaw tasks flow list — shows tracked flows with status and sync mode
  • openclaw tasks flow show <lookup> — inspect one flow by flow id or lookup key
  • openclaw tasks flow cancel <lookup> — cancel a running flow and its active tasks

How flows relate to tasks

Section titled “How flows relate to tasks”

Flows coordinate tasks, not replace them. A single flow may drive multiple background tasks over its lifetime. Use openclaw tasks to inspect individual task records and openclaw tasks flow to inspect the orchestrating flow.

Section titled “Related”