diff --git a/docs/automation/tasks.md b/docs/automation/tasks.md index 96187fde4de..9b3444febcc 100644 --- a/docs/automation/tasks.md +++ b/docs/automation/tasks.md @@ -50,6 +50,15 @@ openclaw tasks notify state_changes # Run a health audit openclaw tasks audit + +# Preview or apply maintenance +openclaw tasks maintenance +openclaw tasks maintenance --apply + +# Inspect TaskFlow state +openclaw tasks flow list +openclaw tasks flow show +openclaw tasks flow cancel ``` ## What creates a task @@ -172,6 +181,27 @@ Surfaces operational issues. Findings also appear in `openclaw status` when issu | `missing_cleanup` | warn | Terminal task with no cleanup timestamp | | `inconsistent_timestamps` | warn | Timeline violation (for example ended before started) | +### `tasks maintenance` + +```bash +openclaw tasks maintenance [--json] +openclaw tasks maintenance --apply [--json] +``` + +Use this to preview or apply reconciliation, cleanup stamping, and pruning for +tasks and Task Flow state. + +### `tasks flow list|show|cancel` + +```bash +openclaw tasks flow list [--status ] [--json] +openclaw tasks flow show [--json] +openclaw tasks flow cancel +``` + +Use these when the orchestrating Task Flow is the thing you care about rather +than one individual background task record. + ## Chat task board (`/tasks`) Use `/tasks` in any chat session to see background tasks linked to that session. The board shows diff --git a/docs/cli/index.md b/docs/cli/index.md index 1431c28804a..d6e90325861 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -952,6 +952,7 @@ List and manage [background task](/automation/tasks) runs across agents. - `tasks notify ` — change notification policy for a task run - `tasks cancel ` — cancel a running task - `tasks audit` — surface operational issues (stale, lost, delivery failures) +- `tasks maintenance` — preview or apply tasks and TaskFlow cleanup/reconciliation - `tasks flow list` — list active and recent Task Flow flows - `tasks flow show ` — inspect a flow by id or lookup key - `tasks flow cancel ` — cancel a running flow and its active tasks diff --git a/docs/cli/status.md b/docs/cli/status.md index 3f0f5bb5bf8..64474a2e87f 100644 --- a/docs/cli/status.md +++ b/docs/cli/status.md @@ -19,7 +19,7 @@ openclaw status --usage Notes: -- `--deep` runs live probes (WhatsApp Web + Telegram + Discord + Google Chat + Slack + Signal). +- `--deep` runs live probes (WhatsApp Web + Telegram + Discord + Slack + Signal). - Output includes per-agent session stores when multiple agents are configured. - Overview includes Gateway + node host service install/runtime status when available. - Overview includes update channel + git SHA (for source checkouts).