Skip to main content

​
TaskFlow

TaskFlow 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

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

​
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

# List active and recent flows
openclaw flows list

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

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

​
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 flows to inspect the orchestrating flow.