cron-limited: 有限次数重复任务 + 农历生日提醒#

重要：处理每日自动检查#

当收到消息「CRON-LIMITED-DAILY-CHECK」时（由每日cron任务触发），必须执行以下步骤：

1. 读取 ~/.openclaw/cron-limited/birthdays.json 配置
2. 获取今天日期（上海时区）
3. 对比配置中每个生日的提醒日期（生日日期 - 提前天数）
4. 如果今天匹配任何提醒日期，使用以下命令发送提醒：

bash

openclaw agent --message "<提醒消息>" --deliver --channel <channel> --to <to>

JSON配置格式：

json

[
  {
    "lunar_month": 8,
    "lunar_day": 15,
    "message": "生日快乐！",
    "time": "10:00",
    "days_before": 3,
    "channel": "openclaw-weixin",
    "to": "o9cq807t3Jl4ow-J7evcB-2LeEzc@im.wechat"
  }
]

提醒消息格式：

• 提前N天： 📅 提醒：农历{月}月{日}日是 {生日阳历日期}，还有 {N} 天！\n{自定义消息}
• 当天： 🎂 今天是农历{月}月{日}日！\n{自定义消息}

---

模式1: 有限次数重复任务#

bash

openclaw cron-limited add \
  --every <duration> \
  --repeat <count> \
  --message "<text>" \
  [--channel <channel>] \
  [--to <destination>]

参数说明：

参数必须说明--every是重复间隔，如 5m、 1h、 30s``--repeat是重复次数，执行N次后自动删除--message是发送的消息内容--channel否渠道，默认 openclaw-weixin``--to否投递目标，默认使用当前会话的目标

示例：

bash

# 每5分钟提醒喝水，共3次
openclaw cron-limited add --every 5m --repeat 3 --message "记得喝水! 💧" \
  --channel openclaw-weixin --to "o9cq807t3Jl4ow-J7evcB-2LeEzc@im.wechat"

---

模式2: 农历生日提醒#

bash

openclaw cron-limited add-lunar \
  --lunar <月份-日期> \
  --message "<text>" \
  [--time <HH:MM>] \
  [--days-before <N>] \
  [--yearly] \
  [--channel <channel>] \
  [--to <destination>]

参数说明：

参数必须说明--lunar是农历月-日，如 8-15 表示农历8月15--message是发送的消息内容--time否提醒时间，默认 08:00``--days-before否提前N天提醒，默认 0（当天）--yearly否是否每年重复，默认 false--channel否渠道，默认 openclaw-weixin``--to否投递目标，默认使用当前会话的目标

示例：

bash

# 农历8月15生日提醒（当天早上10点）
openclaw cron-limited add-lunar --lunar 8-15 \
  --message "🎂 生日快乐！" \
  --time 10:00 \
  --channel openclaw-weixin --to "o9cq807t3Jl4ow-J7evcB-2LeEzc@im.wechat"

# 农历8月15，提前3天提醒
openclaw cron-limited add-lunar --lunar 8-15 \
  --message "🎂 记得准备好庆祝！" \
  --time 09:00 \
  --days-before 3 \
  --yearly \
  --channel openclaw-weixin --to "o9cq807t3Jl4ow-J7evcB-2LeEzc@im.wechat"

# 春节提醒（农历正月初一）
openclaw cron-limited add-lunar --lunar 1-1 \
  --message "🧧 春节快乐！新的一年开始了！" \
  --time 08:00 \
  --yearly \
  --channel openclaw-weixin --to "o9cq807t3Jl4ow-J7evcB-2LeEzc@im.wechat"

---

工作原理#

有限次数重复#

1. 创建主任务（循环任务）
2. 根据 --every 和 --repeat 计算第N次的执行时间
3. 在第N次执行时间 + 1分钟 创建「删除主任务」的一次性任务
4. 主任务执行第N次后，下一分钟自动被删除

农历生日提醒（每年模式）#

1. 将农历日期转换为当年对应的阳历日期
2. 保存配置到 ~/.openclaw/cron-limited/birthdays.json
3. 创建每日检查cron任务（早上7点）
4. 每日检查任务触发时，agent读取配置并发送当日所有提醒

---

依赖#

• Python 3 + lunarcalendar 库
• openclaw CLI
• jq