fix: correct flows docs to tasks (#58690) (thanks @neeravmakwana)

* Docs: fix stale flows command references

* Docs: address flows review comments

* docs: remove stale flows subtree from cli index

* fix: correct flows docs to tasks (#58690) (thanks @neeravmakwana)

---------

Co-authored-by: Ayaan Zaidi <hi@obviy.us>

docs/cli/flows.md

@@ -1,54 +1,36 @@
 ---
-summary: "CLI reference for `openclaw flows` (list, inspect, cancel)"
+summary: "Compatibility note for the mistakenly documented `openclaw flows` command"
 read_when:
-  - You want to inspect or cancel a flow
-  - You want to see how background tasks roll up into a higher-level job
+  - You encounter openclaw flows in older release notes, issue threads, or search results
+  - You want to know what command replaced openclaw flows
 title: "flows"
 ---
 
 # `openclaw flows`
 
-Inspect and manage [ClawFlow](/automation/clawflow) jobs.
+`openclaw flows` is **not** a current OpenClaw CLI command.
+
+Some older release notes and docs mistakenly documented a `flows` command surface. The supported operator surface is [`openclaw tasks`](/automation/tasks).
 
 ```bash
-openclaw flows list
-openclaw flows show <lookup>
-openclaw flows cancel <lookup>
+openclaw tasks list
+openclaw tasks show <lookup>
+openclaw tasks cancel <lookup>
 ```
 
-## Commands
+## Use instead
 
-### `flows list`
+- `openclaw tasks list` — list tracked background tasks
+- `openclaw tasks show <lookup>` — inspect one task by task id, run id, or session key
+- `openclaw tasks cancel <lookup>` — cancel a running background task
+- `openclaw tasks notify <lookup> <policy>` — change task notification behavior
+- `openclaw tasks audit` — surface stale or broken task runs
 
-List tracked flows and their task counts.
+## Why this page exists
 
-```bash
-openclaw flows list
-openclaw flows list --status blocked
-openclaw flows list --json
-```
-
-### `flows show`
-
-Show one flow by flow id or owner session key.
-
-```bash
-openclaw flows show <lookup>
-openclaw flows show <lookup> --json
-```
-
-The output includes the flow status, current step, wait target, blocked summary when present, stored output keys, and linked tasks.
-
-### `flows cancel`
-
-Cancel a flow and any active child tasks.
-
-```bash
-openclaw flows cancel <lookup>
-```
+This page stays in place so existing links from older changelog entries, issue threads, and search results have a clear correction instead of a dead end.
 
 ## Related
 
-- [ClawFlow](/automation/clawflow) — job-level orchestration above tasks
 - [Background Tasks](/automation/tasks) — detached work ledger
 - [CLI reference](/cli/index) — full command tree

docs/cli/index.md

@@ -45,7 +45,7 @@ This page describes the current CLI behavior. If commands change, update this do
 - [`tui`](/cli/tui)
 - [`browser`](/cli/browser)
 - [`cron`](/cli/cron)
-- [`flows`](/cli/flows)
+- [`tasks`](/cli/index#tasks)
 - [`dns`](/cli/dns)
 - [`docs`](/cli/docs)
 - [`hooks`](/cli/hooks)
@@ -172,10 +172,6 @@ openclaw [--dev] [--profile <name>] <command>
     show
     notify
     cancel
-  flows
-    list
-    show
-    cancel
   gateway
     call
     health
@@ -814,14 +810,6 @@ List and manage [background task](/automation/tasks) runs across agents.
 - `tasks cancel <id>` — cancel a running task
 - `tasks audit` — surface operational issues (stale, lost, delivery failures)
 
-### `flows`
-
-List and manage [ClawFlow](/automation/clawflow) jobs across agents.
-
-- `flows list` — show active and recent flows
-- `flows show <id>` — show details for a specific flow
-- `flows cancel <id>` — cancel a flow and its active child tasks
-
 ## Gateway
 
 ### `gateway`