Skip to main content
检查持久化的后台任务和 Task Flow 状态。若不指定子命令, openclaw tasks 等同于 openclaw tasks list 参见 后台任务 了解生命周期和投递 模型,以及其 tasks audit 章节以获取完整的问题描述。

用法

根选项

子命令

list

按最新优先列出已跟踪的后台任务。

show

通过任务 ID、运行 ID 或会话键显示一个任务。

notify

更改正在运行任务的通知策略。

cancel

取消正在运行的后台任务。

retry

重试 1-10 个被阻塞的子代理完成结果投递。子任务执行仍保持成功状态;重试会基于保留的规范结果创建一个隔离的投递代次。较早且存在歧义的确认仍可能导致可见结果重复。

dismiss

记录 1-10 个被阻塞的子代理完成结果的有意不投递。任务会继续显示被阻塞的终止结果,并保留其结果,直到 7 天的完成结果保留期限结束。

audit

显示过期、丢失、投递失败或其他不一致的任务和 Task Flow 记录。保留到 cleanupAfter 的丢失任务属于警告; 已过期或未打时间戳的丢失任务属于错误。 --code 接受任务代码(stale_queuedstale_runninglostdelivery_failedmissing_cleanupinconsistent_timestamps)和 Task Flow 代码(restore_failedstale_waitingstale_blockedcancel_stuckmissing_linked_tasksblocked_task_missing)。参见 后台任务 了解每个代码的严重级别和触发详情。

maintenance

预览或应用任务与 Task Flow 的协调修复、清理标记、 修剪,以及过期 cron 运行会话注册表的清理。 对于 cron 任务,在将旧的活跃任务标记为 lost 之前, 协调会先使用持久化的运行日志/作业状态,因此已完成的 cron 运行不会 仅仅因为内存中的 Gateway 运行时状态消失而成为错误的审计项。 离线 CLI 审计并不是 Gateway 进程内 cron 活跃作业集合的权威来源。 对于带有运行 ID/源 ID 的 CLI 任务,当其活动 Gateway 运行上下文消失时, 即使旧的子会话行仍然存在,也会被标记为 lost 应用后,maintenance 还会修剪 7 天前的 cron:<jobId>:run:<uuid> 会话注册表行, 同时保留当前正在运行的 cron 作业,并且不影响非 cron 会话行。

flow

检查或取消任务账本下持久化的 Task Flow 状态。 flow list --status 接受 queuedrunningwaitingblockedsucceededfailedcancelledlost

相关内容