你是不是有过这样的烦恼——

"每天早上要让它整理新闻，结果忘了触发"

"想让 AI 定时提醒我做事，不知道怎么配置"

"设了个定时任务，结果它没执行"

其实 OpenClaw 早就内置了一套完整的定时任务系统，今天就手把手教你用。

一、 OpenClaw 定时任务是什么？

简单说，就是让 OpenClaw 在指定时间去执行某个任务。

它有几个核心特点：

• 任务持久化：保存在 ~/.openclaw/cron/jobs.json，重启后不丢失
• 多种触发方式：定时定点、间隔循环、标准 cron 表达式
• 灵活的执行模式：可以在主会话执行，也可以开独立会话跑
• 结果可投递：执行完可以发到微信、 Telegram 、 Slack 等频道

二、三种触发方式

1️⃣ 一次性触发（ at ）

设定一个具体时间，到点执行一次就结束。

适合：临时的单次提醒、会议提醒、限时任务。

openclaw cron add \ --name "产品发布会提醒" \ --at "2026-04-10T10:00:00" \ --session isolated \ --message "今天10点有产品发布会，记得参加！" \ --announce

2️⃣ 间隔循环（ every ）

每隔一段固定时间执行一次。

适合：定期检查、日报生成、数据监控。

openclaw cron add \ --name "每30分钟检查库存" \ --every "30m" \ --session isolated \ --message "检查一下库存数据，有异常及时报告" \ --announce

3️⃣ 标准 Cron 表达式（ cron ）

支持 5 字段或 6 字段 cron 表达式，可设置时区。

适合：复杂的定时需求，如"每个工作日早上 9 点"、"每周一上午 10 点"。

openclaw cron add \ --name "早间新闻摘要" \ --cron "0 7 * * *" \ --tz "Asia/Shanghai" \ --session isolated \ --message "整理今日AI行业最新动态" \ --announce

常用 cron 表达式对照：

三、四种执行模式

1️⃣ 主会话模式（ main ）

在主会话中插入一个系统事件，依赖下次心跳触发。

适合：简单的提醒、不需要独立运行的轻量任务。

--session main --system-event "提醒：检查日历"

2️⃣ 独立会话模式（ isolated ）⭐最常用

开启一个全新的隔离会话来执行，有独立的上下文。

适合：新闻摘要、报告生成、数据分析等后台任务。

--session isolated --message "生成今日A股行情报告"

3️⃣ 当前会话模式（ current ）

绑定到创建时的会话执行。

适合：需要保持上下文连贯性的任务。

4️⃣ 自定义会话模式（ custom ）

指定一个命名会话，任务会在该会话的历史上下文中执行。

适合：需要跨次累积信息的场景，比如每日站会总结。

四、结果怎么收？

OpenClaw 支持三种投递模式：

• announce：执行完后把结果发送到指定频道（默认）
• webhook： POST 到外部 HTTP 地址
• none：只内部执行，不对外投递

发送到微信示例：

--announce --channel openclaw-weixin --to "用户的微信ID"

发送到 Telegram ：

--announce --channel telegram --to "chat_id"

五、管理命令

openclawcronlist openclawcronedit--message"新的任务描述" openclawcronrun openclawcronremove openclawcronruns--id--limit20

六、实战场景

场景 1 ：每日早上 8 点推送新闻摘要

openclaw cron add \ --name "早间AI新闻" \ --cron "0 8 * * *" \ --tz "Asia/Shanghai" \ --session isolated \ --message "请整理今日AI行业最新动态，输出300字摘要" \ --announce

场景 2 ：每周一早上 10 点提醒写周报

openclaw cron add \ --name "周报提醒" \ --cron "0 10 * * 1" \ --tz "Asia/Shanghai" \ --session isolated \ --message "新的一周开始了，整理一下上周的工作成果吧" \ --announce

场景 3 ：股票价格监控提醒

openclaw cron add \ --name "收盘提醒" \ --cron "0 15 * * 1-5" \ --tz "Asia/Shanghai" \ --session isolated \ --message "今日收盘了，请检查自选股涨跌情况并生成简报" \ --announce

七、注意事项

1. 时区要设置对：不加 --tz 默认用主机时区，建议明确指定 Asia/Shanghai
2. 独立会话有隔离： isolated 模式每次都是全新会话，不继承主会话的上下文
3. 结果需要投递：如果没人接收，执行完就消失了，记得加 --announce
4. 任务持久化：重启 OpenClaw 后任务不会丢，但 Gateway 要保持运行

总结

OpenClaw 的定时任务系统非常完整，核心就是三点：

• 触发条件：at / every / cron 三种方式
• 执行模式：main / isolated / current / custom 四种风格
• 结果投递：announce / webhook / none 三种去向

搞懂这三个维度，你就可以搭建出各种自动化工作流了。

往期精选

• OpenClaw + 微信：如何用 AI 自动回复公众号留言？
• OpenClaw Memory ：让 AI 拥有持久记忆的秘诀
• OpenClaw 多 Agent 协作：一个人配出整支 AI 团队

沐沐 AI| 专注 AI 知识与 OpenClaw 使用技巧