vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-04 22:30:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: refresh tasks and status references

Browse Source
This commit is contained in:
Peter Steinberger
2026-04-04 08:24:14 +01:00
parent 0a5bce21a6
commit 09997f032f
3 changed files with 32 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
docs/automation/tasks.md
View File

@@ -50,6 +50,15 @@ openclaw tasks notify <lookup> state_changes
# Run a health audit # Run a health audit
openclaw tasks 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 <lookup>
openclaw tasks flow cancel <lookup>
``` ```
## What creates a task ## 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 | | `missing_cleanup` | warn | Terminal task with no cleanup timestamp |
| `inconsistent_timestamps` | warn | Timeline violation (for example ended before started) | | `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 <status>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
```
Use these when the orchestrating Task Flow is the thing you care about rather
than one individual background task record.
## Chat task board (`/tasks`) ## Chat task board (`/tasks`)
Use `/tasks` in any chat session to see background tasks linked to that session. The board shows Use `/tasks` in any chat session to see background tasks linked to that session. The board shows

1
docs/cli/index.md
View File

@@ -952,6 +952,7 @@ List and manage [background task](/automation/tasks) runs across agents.
- `tasks notify <id>` — change notification policy for a task run - `tasks notify <id>` — change notification policy for a task run
- `tasks cancel <id>` — cancel a running task - `tasks cancel <id>` — cancel a running task
- `tasks audit` — surface operational issues (stale, lost, delivery failures) - `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 list` — list active and recent Task Flow flows
- `tasks flow show <lookup>` — inspect a flow by id or lookup key - `tasks flow show <lookup>` — inspect a flow by id or lookup key
- `tasks flow cancel <lookup>` — cancel a running flow and its active tasks - `tasks flow cancel <lookup>` — cancel a running flow and its active tasks

2
docs/cli/status.md
View File

@@ -19,7 +19,7 @@ openclaw status --usage
Notes: 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. - Output includes per-agent session stores when multiple agents are configured.
- Overview includes Gateway + node host service install/runtime status when available. - Overview includes Gateway + node host service install/runtime status when available.
- Overview includes update channel + git SHA (for source checkouts). - Overview includes update channel + git SHA (for source checkouts).