快速开始
`openclaw tasks`
检查持久化后台任务和 Task Flow 状态。不带子命令时，
openclaw tasks 等同于 openclaw tasks list。
有关生命周期和交付模型，请参阅后台任务；有关完整的发现项说明，
请参阅其中的 tasks audit 章节。
用法
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>根选项
| 标志 | 说明 |
|---|---|
--json |
输出 JSON。 |
--runtime <name> |
按类型筛选：subagent、acp、cron 或 cli。 |
--status <name> |
按状态筛选：queued、running、succeeded、failed、timed_out、cancelled 或 lost。 |
子命令
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]按从新到旧的顺序列出已跟踪的后台任务。
show
openclaw tasks show <lookup> [--json]按任务 ID、运行 ID 或会话键显示一个任务。
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>更改运行中任务的通知策略。
cancel
openclaw tasks cancel <lookup>取消运行中的后台任务。
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]显示过期、丢失、交付失败或存在其他不一致情况的任务和
Task Flow 记录。保留至 cleanupAfter 的丢失任务属于警告；
已过期或未加时间戳的丢失任务属于错误。
--code 接受任务代码（stale_queued、stale_running、lost、
delivery_failed、missing_cleanup、inconsistent_timestamps）和 Task
Flow 代码（restore_failed、stale_waiting、stale_blocked、
cancel_stuck、missing_linked_tasks、blocked_task_missing）。有关每个
代码的严重性和触发条件详情，请参阅后台任务。
maintenance
openclaw tasks maintenance [--apply] [--json]预览或应用任务和 Task Flow 协调、清理标记、修剪以及过期 cron 运行会话注册表清理。
对于 cron 任务，协调过程会先使用持久化的运行日志和作业状态，再将旧的活动任务
标记为 lost，因此已完成的 cron 运行不会仅仅因为内存中的 Gateway 网关运行时
状态已消失而成为错误的审计错误。离线 CLI 审计无法对 Gateway 网关进程本地的
cron 活动作业集合做出权威判断。具有运行 ID/源 ID 的 CLI 任务在其有效的
Gateway 网关运行上下文消失时会被标记为 lost，即使旧的子会话行仍然存在。
应用维护操作时，还会修剪超过 7 天的 cron:<jobId>:run:<uuid> 会话
注册表行，同时保留当前正在运行的 cron 作业，并且不改动非 cron 会话行。
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>检查或取消任务账本中的持久化 Task Flow 状态。
flow list --status 接受 queued、running、waiting、blocked、
succeeded、failed、cancelled 或 lost。
