Appearance
openclaw tasks 是管理 OpenClaw 后台任务和 Task Flow 持久化状态的 CLI 命令组。使用它可以列出、查看、取消任务，修改通知策略，审计异常记录，以及执行维护清理（如标记失联任务、清理过期的 cron 会话注册）。支持按运行类型（subagent/acp/cron/cli）和状态（queued/running/failed 等）过滤，输出支持 JSON 格式。
OpenClaw tasks 任务管理 CLI 命令参考
检查持久化的后台任务与 Task Flow 状态。不带子命令时，openclaw tasks 等同于 openclaw tasks list。
任务生命周期和投递模型见后台任务。
用法
bash
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
bash
openclaw tasks list [--runtime <name>] [--status <name>] [--json]列出追踪中的后台任务，最新优先。
show
bash
openclaw tasks show <lookup> [--json]按任务 ID、运行 ID 或会话键显示单个任务详情。
notify
bash
openclaw tasks notify <lookup> <done_only|state_changes|silent>修改正在运行的任务的通知策略。
cancel
bash
openclaw tasks cancel <lookup>取消正在运行的后台任务。
audit
bash
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]检查过期、失联、投递失败或不一致的任务及 Task Flow 记录。失联任务在 cleanupAfter 期限内属于警告级别，超期或缺少时间戳的失联任务属于错误级别。
maintenance
bash
openclaw tasks maintenance [--apply] [--json]预览或执行任务与 Task Flow 的对账、清理标记、修剪以及过期的 cron 运行会话注册表清理。
- 对于 cron 任务，对账会参考持久化的运行日志/作业状态，再决定是否将旧的活动任务标记为
lost，这样已完成的 cron 运行不会因网关进程内存状态丢失而产生误报的审计错误。离线 CLI 审计对网关进程本地的 cron 活动任务集不具有权威性。 - 拥有运行 ID/源 ID 的 CLI 任务，当其实时网关运行上下文消失时会被标记为
lost，即使旧子会话行仍然保留。 - 执行维护时，也会清理超过 7 天的
cron:<jobId>:run:<uuid>会话注册表行，同时保留当前正在运行的 cron 任务，不触碰非 cron 会话行。
flow
bash
openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>检查或取消任务账本下的持久化 Task Flow 状态。
相关文档
常见问题
怎么取消一个正在运行的后台任务？
使用 openclaw tasks cancel <lookup> 命令，其中 <lookup> 可以是任务 ID、运行 ID 或会话键。取消操作立即生效，无法恢复。
审计发现大量 lost 状态的任务怎么办？
先运行 openclaw tasks maintenance --apply 执行维护清理。对于 cron 任务，离线审计可能误报，维护命令会基于持久化日志正确标记。如果只是预览，可使用 openclaw tasks maintenance（不加 --apply）查看待处理项。
如何只查看运行失败的任务？
使用 openclaw tasks list --status failed 即可筛选出所有失败的任务。如果需要 JSON 输出，加上 --json。