OpenClaw �� Cro个月,终于让 AI “活起来”自动干活了.

你有没有遇到过这种情况——想让 AI 每天早上自动汇报天气、提醒你喝水，或者每周五自动生成一份工作小结？但总不能 24 小时守在手机旁边等它回复吧。

其实 OpenClaw 早就想到了这个问题。它内置了一套定时任务系统，简单来说就是：你可以提前安排好任务，让 AI 在指定时间自动跑一遍，然后把结果发给你。

这篇文章手把手教你配置自己的第一个定时任务。

一、先搞清楚 Cron 是什么

Cron 是 Gateway 网关内置的调度器。它会持久化任务，在正确时间唤醒智能体，并且可以将输出回传到聊天渠道或 webhook 端点。

Cron 定时任务的核心在于时间规则。OpenClaw 支持三种配置方式：

1. --at 一次性时间

--at "2026-02-01T16:00:00Z"# 具体时间戳--at "20m"# 20分钟后

适合那种”到点提醒我干某事”的场景。

2. --every 固定间隔

--every "6h"# 每6小时跑一次

适合需要频繁检查的任务。

3. --cron 标准表达式

--cron "0 7 * * *"# 每天早上7点--cron "0 9 * * 1"# 每周一早上9点

这就是传说中的五字段表达式，分别代表：分钟、小时、日期、月份、星期几。

一个小提示：如果不加 --tz 参数，默认用 UTC 时间。咱们的北京时间记得加 --tz "Asia/Shanghai"。

二、主会话 vs 独立会话：到底该选哪个？

这是最容易懵的地方。OpenClaw 的定时任务有四种运行模式：

我的建议：

• • 简单提醒、查日历 → 用 main
• • 定期报告、汇总信息 → 用 isolated
• • 需要连续对话上下文 → 用 session:xxx

两者的区别在于：主会话会带着你们之前的聊天记录跑，独立会话则是干净的新会话，不会打扰你正在进行的聊天。

三、Web UI 一键设置

如果你觉得命令行麻烦，OpenClaw 提供了Web 控制面板，可以直接在浏览器里管理定时任务。

1. 打开控制面板

openclaw dashboard

这行命令会同时做三件事：

• • 复制 Dashboard 链接到剪贴板
• • 尝试自动打开浏览器
• • 如果是远程连接，会显示 SSH 隧道提示

本地直接访问：http://127.0.0.1:18789/

2. 进入定时任务面板

登录后，在左侧菜单找到 定时任务，点击进入。

3. 创建新任务

右侧菜单有一个 新建任务的填写模板，直接填写即可：

生成的配置文件如下，位置在~\.openclaw\cron\jobs.json

{"version": 1,"jobs": [    {"id": "289a629a-8c03-498a-b537-5227c3efb6b6","name": "早安天气","description": "每天6时查询天气。","enabled": true,"deleteAfterRun": false,"createdAtMs": 1776863883794,"schedule": {"kind": "cron","expr": "0 6 * * *","tz": "Asia/Shanghai","staggerMs": 1560000      },"sessionTarget": "main","wakeMode": "now","payload": {"kind": "systemEvent","text": "用weather技能查询兰州天气"      },"agentId": "main","state": {}    }     ]}

4. 管理已有任务

• • 编辑：修改配置
• • 克隆：复制任务
• • 禁用：开关任务
• • Run：立刻跑一次
• • 编辑：修改配置
• • 历史：看执行历史
• • Delete：删除任务

Web UI 的好处：表单会自动验证填写内容，有错误会提示，不用记命令参数。

四、命令行创建

场景一：每天晚上20时自动发天气到QQbot

每天晚上 20 点（北京时间）让 AI 自动查天气发给 QQbot：

openclaw cron add --name "晚安天气" --description "每天20时查询天气" --cron "0 20 * * *" --tz "Asia/Shanghai" --session isolated --message "用weather技能查兰州的天气" --announce --channel qqbot --to "你的qqbot user_openid"

生成的配置文件如下

{"version": 1,"jobs": [    {"id": "bf186ab8-510c-47a0-b8b0-b1f46cc75c03","name": "晚安天气","description": "每天20时查询天气","enabled": true,"createdAtMs": 1776937258156,"schedule": {"kind": "cron","expr": "0 18 * * *","tz": "Asia/Shanghai"      },"sessionTarget": "isolated","wakeMode": "now","payload": {"kind": "agentTurn","message": "用weather技能查兰州的天气"      },"delivery": {"mode": "announce","channel": "qqbot","to": "你的qqbot user_openid","bestEffort": false      },"deleteAfterRun": false,"state": {}    }  ]}

openid在网关查找，先在QQ端给机器人随便发个消息，然后去找。

也可以发微信，只修改 –channel openclaw-weixin –to “你的用户openid@im.wechat“

{"delivery": {"mode": "announce","channel": "openclaw-weixin","to": "你的用户openid@im.wechat",      }

openid在会话中查找，先在微信端给机器人随便发个消息，然后去找。

还可以发飞书，只修改 –channel feishu –to “你的用户openid“

{"delivery": {"mode": "announce","channel": "feishu","to": "你的用户openid",      }

openid在会话中查找，先在飞书端给机器人随便发个消息，然后去找。

场景二：每周五下午自动汇总

openclaw cron add \  --name "周报自动生成" \  --cron "0 17 * * 5" \  --tz "Asia/Shanghai" \  --session isolated \  --message "总结本周的工作内容" \  --announce \  --channel qqbot \  --to "你的qqbot user_openid"

五、常见的坑与解决方法

1. 时区搞错

• • 没加 --tz？默认 UTC，小心早上 7 点变成凌晨。
• • 建议明确写上时区，比如 --tz "Asia/Shanghai"。

2. 任务没跑起来

• • 先检查 Gateway 在没在运行：openclaw status
• • 再看任务状态：openclaw cron list
• • 看执行历史：openclaw cron runs --id <jobId>

3. 发了但没收到

• • 检查 delivery 模式是 announce 还是 none
• • 确认 channel 和 to 参数写对了

六、进阶玩法

• • 模型选择：--model "opus" 可以指定某个模型跑这个任务
• • 思考深度：--thinking high 让任务跑得更仔细
• • 工具限制：--tools exec,read 只给特定权限
• • 失败通知：配置 cron.failureDestination 接收错误推送

总结一下

定时任务核心就三点：

1. 1. 时间规则：--at / --every / --cron
2. 2. 运行模式：main（上下文）还是 isolated（独立）
3. 3. 输出方式：announce 发消息，webhook 调接口，none 自己跑

配置好之后，AI 就能在你不在的时候自动干活了。算是真正让助手”24小时待命”吧。

本文基于OpenClaw2026.4.21版本，内容经过验证。