Cron Jobs

定时任务就像一个会准时工作的小机器人。它住在 OpenClaw 的“网关”里，会记住你让它做什么、什么时候做，然后到时间就叫醒“代理”去干活。它会把要做的事情记在一个小本本上（在 ~/.openclaw/cron/ 文件夹里），所以就算电脑重启了，它也不会忘记。

第一步：告诉小机器人“什么时候”工作 你要先定一个时间表。

1. 一次性的提醒：用 --at 告诉它一个具体的时间点，比如 2026-02-01T16:00:00Z。
2. 重复的工作：用 --cron 告诉它一个像密码一样的时间规则，比如 0 7 * * * 就是每天早上 7 点。你还可以用 --tz 告诉它你用的是哪个时区的时间。 这里要小心：如果你写的时间没有时区（比如 2026-02-01T16:00:00），小机器人会把它当成“世界标准时间”哦。

第二步：告诉小机器人“在哪里”工作 小机器人可以在两个地方工作。

1. 在主会话里工作 (--session main)：它会像平时聊天一样，在“心跳”的时候，把你要做的事情加进去一起处理。
2. 在单独的小房间里工作 (--session isolated)：它会自己开一个叫 cron:<工作ID> 的小房间，专门处理你给的任务，不会打扰到主聊天。

第三步：告诉小机器人“做什么” 根据你选的“在哪里”，你要给它不同的指令。

1. 如果在主会话里工作，你要用 --system-event 告诉它一个系统事件，比如“提醒：检查草稿”。
2. 如果在单独的小房间里工作，你要用 --message 告诉它一个具体的任务，比如“总结一下昨晚的更新”。

第四步：告诉小机器人“做完后怎么办” 特别是对于在“单独小房间”里完成的工作，你可以决定要不要把结果告诉大家。

1. 宣布一下 (--announce)：小机器人会把结果发到你指定的聊天频道（比如 Slack、微信），并且会在主会话里简单说一句“我做完了”。
2. 发个网络通知 (delivery.mode = "webhook")：小机器人会把结果通过一个网址（URL）发送出去，就像寄一封信。
3. 什么都不做 (delivery.mode = "none)：小机器人自己知道做完了，但谁也不告诉。 这里要小心：如果你没有特别说明，在“单独小房间”里做的工作，小机器人会默认选择“宣布一下”。

一些重要的提醒和限制

• 小机器人会犯错吗？ 会的。如果因为网络不好、对方服务器太忙等原因失败了，小机器人会再试几次（这叫“重试”）。但如果是因为密码错了这种解决不了的问题，它就会立刻停下来。
• 可以换一个更聪明的脑子吗？ 可以！在“单独小房间”里工作时，你可以用 --model 和 --thinking 命令，让小机器人换一个更厉害的“大脑模型”来思考问题。
• 小心别弄丢了！ 所有的工作安排都保存在 ~/.openclaw/cron/jobs.json 这个文件里。如果你想直接修改这个文件，必须先关掉网关程序，不然可能会弄乱。
• 如果它不工作怎么办？ 首先检查一下，配置文件里的 cron.enabled 是不是 true，或者环境变量 OPENCLAW_SKIP_CRON 有没有被设置成 1。还要确保网关程序一直在运行哦。