新手必看:超详细OpenClaw Cron定时任务实现每日计划提醒的完整步骤与技巧
前言
每天查看计划清单,几乎是每个开发者的固定动作。但说实话,哪怕再自律的人,也总有疏忽的时候——忙起来就忘了看,等想起来时,已经是下午了。最近试了一下 OpenClaw 自带的 Cron 定时任务系统,发现这个痛点能轻松解决:让 AI 每天固定时间主动提醒,省心多了。
下面直接上配置方法,流程比想象中简单。
什么是 OpenClaw Cron?
OpenClaw 的 Cron 其实是一个内置的定时任务调度系统,底层类似于 Linux 的 crontab,但专门为 AI 助手做了适配。它能做到的事情还挺实用的:
- 定时触发 AI 执行任务
- 把消息发送到飞书、Telegram、Discord 等渠道
- 支持一次性任务和周期性任务
- 完全通过命令行管理,不需要写代码
换句话说,如果你需要一个 AI 助手每天按时给你发提醒、推送信息,这就是个现成的工具。
实战:创建每天早上 9 点的计划提醒
第一步:确认 Gateway 服务运行
要保证 Cron 任务顺利运行,得先确认 OpenClaw Gateway 服务是否在线。执行这个命令看一眼:
openclaw gateway status
如果没启动,那就手动启动一下:
openclaw gateway start
第二步:创建定时任务
接下来就是关键环节了,执行以下命令:
openclaw cron add --name "每日计划提醒" --cron "0 9 * * *" --tz "Asia/Shanghai" --message "⏰ 早上好!该查看今天的计划清单啦~ 新的一天,新的目标,加油!✨" --channel feishu --to "你的飞书用户ID" --best-effort-deliver --session isolated --wake now
每个参数都有它的使命,我们来逐一拆解:
| 参数 | 作用 |
|---|---|
--name | 任务名称,方便后续管理 |
--cron "0 9 * * *" | Cron 表达式,代表每天 9 点 0 分执行 |
--tz "Asia/Shanghai" | 指定时区,避免时差导致的混乱 |
--message | 提醒的具体内容,你完全可以自定义 |
--channel feishu | 消息发送到飞书 |
--to | 必填!如果是飞书、QQ、微信等,必须指定接收人的用户 ID |
--best-effort-deliver | 确保消息尽可能送达,建议加上 |
--session isolated | 在独立会话中执行,安全隔离 |
--wake now | 立即激活任务 |
⚠️ 这里有个容易踩的坑:飞书、钉钉等国内平台必须加 --to 参数。如果不加,任务虽然能创建成功,但消息根本发不出去,错误信息看起来就是:
No delivery target resolved for channel "feishu". Set delivery.to.
那怎么拿到你的飞书用户 ID?有两种常用方法:
- 查看 OpenClaw 系统消息中的
user:字段 - 直接问 AI 助手 "我的用户 ID 是什么"
举个例子,飞书渠道的用户 ID 大概长这样:
--channel feishu --to "ou_42bcdd5dsff6b4a04f..."
如果是 QQ 渠道,就是:
--channel qqbot --to "B3EA9A1d-2D3c-5CBD-..."
第三步:验证任务创建成功
执行:
openclaw cron list
输出中应该能看到刚才创建的任务。更直接的方式是用飞书检查——如果收到消息,就说明配置成功了。
Cron 表达式速查
除了每天早上 9 点,其他时间也可以灵活设置,参考下面这张表:
| 需求 | 表达式 |
|---|---|
| 每天早 8 点 | 0 8 * * * |
| 工作日早 9 点 | 0 9 * * 1-5 |
| 每周一早上 | 0 9 * * 1 |
| 每小时整点 | 0 * * * * |
| 每晚 10 点 | 0 22 * * * |
任务管理常用命令
任务建好了,日常管理也少不了。这几个命令基本够用了:
# 查看所有任务
openclaw cron list
# 立即手动运行一次(测试用)
openclaw cron run <任务ID>
# 临时禁用任务
openclaw cron disable <任务ID>
# 重新启用
openclaw cron enable <任务ID>
# 删除任务
openclaw cron rm <任务ID>
总结
总的来说,OpenClaw 的 Cron 系统让定时提醒变得非常直接,不需要写冗余的代码,也不需要维护复杂的外部服务。对于需要每天准时收到提醒的人来说,确实是个效率利器。
早上 9 点,AI 准时出现在飞书里提醒你干活——再也不用担心忘了看清单。
参考链接:
- OpenClaw 文档 - Cron 调度
- Cron 表达式在线工具