Automation 导读

背景任务不是调度器,是活动记账本

这一页讲的是后台任务记录——ACP运行、子代理、定时任务、CLI操作等脱离主会话的工作,都会生成一条任务记录,跟踪它何时开始、是否成功。最该先看的是“什么会创建任务”那张表,它直接告诉你哪些操作会产生记录、哪些不会(心跳轮次和普通聊天不会)。容易搞错的是:任务只管记录,不管调度,定时任务由cron决定何时跑,任务只是事后记一笔;另外,完成通知是推送驱动的,轮询状态通常是错误做法。

先讲这一页到底在解决什么

背景任务不是调度器,是活动记账本

这一页讲的是后台任务记录——ACP运行、子代理、定时任务、CLI操作等脱离主会话的工作,都会生成一条任务记录,跟踪它何时开始、是否成功。最该先看的是“什么会创建任务”那张表,它直接告诉你哪些操作会产生记录、哪些不会(心跳轮次和普通聊天不会)。容易搞错的是:任务只管记录,不管调度,定时任务由cron决定何时跑,任务只是事后记一笔;另外,完成通知是推送驱动的,轮询状态通常是错误做法。

原文共 14 节,先看 Start Here 路径:/automation/tasks 查看官方原文

第一站

📓 它像账本,不像日程表

最容易混的地方就是:任务会记录工作,但不会替你安排时间。

记录而不是调度

谁跑了、什么时候跑、最后有没有成功,这里都能看。

主会话外的活

不像正常聊天那样一直待在前台。

不取代 sessions

它是账本,不是对话本身。

第二站

🚦 三段状态,像一张跑腿小票

任务从排队,到出发,到结束,都有痕迹。

1

queued

像站在队伍里,等着轮到你。

2

running

像已经被派出去,正在路上。

3

terminal

像任务结束了,结果落袋。

📌

完成态不是一个值

成功、失败、超时、取消、丢失,都算 terminal 家族。

第三站

🛠 CLI 和 cron 都会来这儿记账

凡是“跑出去”的工作,最后都得能查。

openclaw tasks list

像翻总账本,看看最近都有哪些跑腿单。

openclaw tasks show <lookup>

像点开某一张单子看细节。

openclaw tasks audit

像让系统帮你把异常单子单独拎出来。

最后总结

🎈 把 Background Tasks 这页压成一句最好记的话

Background Tasks 是总账本,不负责安排工作时间,只负责把跑出去的后台工作记清楚、查得到、追得回。