OpenClaw实战:Cron定时任务与Heartbeat主动推送完全指南

用户：帮我总结今天的邮件
AI：好的，让我看看你的邮件...
AI：今天有3封重要邮件需要处理...

每天08:00→AI自动检查邮件/日历/天气
08:05→生成简报推送到微信
08:06→你起床看到完整简报，节省30分钟

# 查看所有定时任务
openclawcronlist

# 添加新的定时任务
openclawcronadd--name"Morning Brief"--cron"0 8 * * *"--message"Generate daily briefing"

# 立即运行某个任务（测试用）
openclawcronrun<jobId>

# 禁用/启用任务
openclawcrondisable<jobId>
openclawcronenable<jobId>

# 查看任务执行历史
openclawcronruns--id<jobId>

# 删除任务
openclawcronrm<jobId>

┌───────────── 分钟 (0-59)
│ ┌───────────── 小时 (0-23)
│ │ ┌───────────── 日 (1-31)
│ │ │ ┌───────────── 月 (1-12)
│ │ │ │ ┌───────────── 周 (0-6, 0=周日)
│ │ │ │ │
* * * * *

openclawcronadd\
--name"Weekly Report"\
--cron"0 9 * * 1"\
--sessionmain\
--system-event"Generate weekly report"

openclawcronadd\
--name"Morning Brief"\
--cron"0 8 * * *"\
--sessionisolated\
--message"Generate daily briefing"\
--announce

openclawcronadd\
--name"任务名称"\
--cron"分 时 日 月 周"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"要执行的自然语言指令"\
--announce\
--modelminimax/MiniMax-M2.7\
--max-time300\
--delete-after-run

┌─────────────────────────────────────────┐
│           HEARTBEAT 循环                │
├─────────────────────────────────────────┤
│                                          │
│   第N次执行（约30分钟间隔）               │
│         ↓                                │
│   读取 HEARTBEAT.md                      │
│         ↓                                │
│   执行清单中的检查项：                    │
│   - 邮箱有新邮件吗？                      │
│   - 日历有即将到来的事件吗？              │
│   - 天气状况如何？                        │
│         ↓                                │
│   生成汇总报告                           │
│         ↓                                │
│   推送到聊天渠道（如果有必要）             │
│         ↓                                │
│   等待下一个周期                          │
│                                          │
└─────────────────────────────────────────┘

# HEARTBEAT.md

## 每次检查的项目

-检查Gmail未读邮件（高优先级）
-检查今天和明天的日历事件
-检查天气（针对广州）
-检查是否有定时任务失败

## 只在特定时间检查

-每周一09:00：生成上周工作周报
-每天08:00：生成早间简报

## 有变化时的推送规则

-如果有高优先级邮件，立即推送
-如果天气有剧烈变化（>10度），立即推送
-否则保持静默，汇总在晚间报告

# 查看当前配置
openclawheartbeatstatus

# 配置检查间隔（单位：秒）
openclawheartbeatinterval1800# 30分钟
openclawheartbeatinterval3600# 1小时

# 手动触发一次心跳
openclawheartbeatrun--now

# 查看最近的心跳执行记录
openclawheartbeathistory--last10

优先级1（立即推送）：邮件中有来自"老板@公司.com"的未读
优先级2（合并推送）：有3个日历事件在接下来2小时内
优先级3（静默）：天气晴朗，适合出行

# 1. 创建Cron任务
openclawcronadd\
--name"Daily Morning Brief"\
--cron"0 8 * * *"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请检查今天的天气（广州）、日历事件、未读邮件，生成一份简洁的早间简报，包含：1)天气状况和出行建议 2)今日日程 3)需要处理的邮件 4)今日待办事项"\
--announce

☀️ 早间简报 | 5月16日 周五

【天气】广州 26°C 晴朗 湿度65%
   出行建议：适合户外，记得防晒

【日程】今天3个事件
   09:00 团队周会（腾讯会议）
   14:00 项目评审
   19:00 论文arXiv更新推送

【邮件】2封需要处理
   📧 张三：关于季度报告的反馈
   📧 系统通知：服务器监控报告

【待办】今日重点
   ✅ 完成项目方案初稿
   ⬜ 准备周五分享PPT

openclawcronadd\
--name"Weekly Report"\
--cron"0 9 * * 1"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请汇总上周的工作情况：1)GitHub提交统计 2)本周完成的任务 3)遇到的问题和解决方案 4)本周重要日历事件 5)下周工作计划。格式化为Markdown表格。"\
--announce

# 配置每日19:00的论文推送
openclawcronadd\
--name"arXiv Daily Paper"\
--cron"0 19 * * *"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请访问arXiv cs.AI cs.CL cs.LG分类，获取今天最新的大模型相关论文，筛选8-10篇最具价值的，生成带摘要的论文速递，格式为：标题、作者、摘要（100字）、arXiv链接"\
--announce

## 邮件检查（约每2小时）

-连接Gmail，读取最近20封未读邮件
-按紧急程度分类：
-紧急（来自老板/客户）：立即推送到微信
-普通：标记为待处理，汇总在晚间报告
-垃圾邮件：自动归档
-对于可自动回复的邮件（会议邀请、常规确认），起草回复草稿

# 微信公众号草稿箱定时更新
openclawcronadd\
--name"WeChat Content Update"\
--cron"0 20 * * 3,6"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请执行公众号内容发布流程：1)读取next-article.md中的文章内容 2)生成5张配图 3)进行三步预检（排版优化、敏感词检测、重复检测）4)上传到微信公众号草稿箱 5)推送发布结果"\
--announce

openclawcronadd\
--name"Competitor Watch"\
--cron"0 10 * * 5"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请执行竞品监控流程：1)访问以下网址获取最新内容 [列表] 2)对比上周数据，找出新增/变化内容 3)生成监控报告，包含：新增页面、更新内容、价格变动 4)如果发现重大变化立即推送"\
--announce

# 每15分钟检查一次
openclawcronadd\
--name"System Health Check"\
--cron"*/15 * * * *"\
--tz"Asia/Shanghai"\
--sessionisolated\
--message"请检查系统状态：1)CPU和内存使用率 2)磁盘空间 3)重要服务运行状态 4)错误日志（过去1小时）5)安全日志（登录失败）如果任何指标超过阈值或发现异常，立即推送告警；否则静默。"\
--announce

┌─────────────────────────────────────────┐
│              Cron定时任务                │
│  08:00 每日简报                         │
│  09:00 周一/周五报告                     │
│  19:00 每日论文推送                      │
│  20:00 公众号内容发布                    │
├─────────────────────────────────────────┤
│              Heartbeat后台检查            │
│  每30分钟：邮件/日历/天气                  │
│  每60分钟：系统状态/竞品动态               │
│  持续：记忆整理/上下文更新                │
└─────────────────────────────────────────┘

# 在openclaw.json中配置
{
"announcements":{
"deduplicate":true,
"cooldownMinutes":60
}
}

# 为Cron任务指定更便宜的模型
openclawcronadd\
--name"Brief"\
--cron"0 8 * * *"\
--modelminimax/MiniMax-M2.7\
--message"简报生成"

# 设置最大执行时间避免超时消耗
openclawcronadd\
--name"Web Scrap"\
--cron"0 10 * * *"\
--max-time120\
--message"抓取数据"

# 问题：任务显示"skipped"
# 原因：上一个实例还在运行
# 解决：增加max-time或检查任务是否卡住

# 问题：任务执行了但没有推送
# 原因：没有加--announce参数
# 解决：重新添加任务或编辑现有任务

# 问题：时区不对
# 原因：cron默认使用UTC
# 解决：添加--tz参数明确指定时区

# 检查HEARTBEAT.md是否存在
ls-laHEARTBEAT.md

# 检查心跳间隔
openclawheartbeatstatus

# 手动触发测试
openclawheartbeatrun--now

# 查看心跳日志
openclawlogs--filterheartbeat

Cron（精确时间）     → 执行确定性任务（报告、发布、总结）
Heartbeat（持续运行） → 检查环境变化（邮件、天气、状态）