快速开始
`openclaw tasks`
检查持久化后台任务和 Task Flow 状态。没有子命令时，openclaw tasks 等同于 openclaw tasks list。
有关生命周期和投递模型，请参阅 后台任务。
用法
openclaw tasks
openclaw tasks list
openclaw tasks list --runtime acp
openclaw tasks list --status running
openclaw tasks show <lookup>
openclaw tasks notify <lookup> state_changes
openclaw tasks cancel <lookup>
openclaw tasks audit
openclaw tasks maintenance
openclaw tasks maintenance --apply
openclaw tasks flow list
openclaw 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 的丢失任务属于警告；已过期或未打标记的丢失任务属于错误。
maintenance
openclaw tasks maintenance [--apply] [--json]
预览或应用任务和 Task Flow 对账、清理标记以及修剪。
对于 cron 任务，对账会在将旧的活动任务标记为 lost 之前，先使用持久化的运行日志/作业状态，因此已完成的 cron 运行不会仅因为内存中的 Gateway 网关运行时状态消失而变成错误的审计错误。
离线 CLI 审计并不能作为 Gateway 网关进程本地 cron 活动作业集合的权威依据。
flow
openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
检查或取消任务账本下持久化的 Task Flow 状态。