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