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

重要：处理每日自动检查

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

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

openclaw agent --message "\x3C提醒消息>" --deliver --channel \x3Cchannel> --to \x3Cto>

JSON配置格式：

[
  {
    "lunar_month": 8,
    "lunar_day": 15,
    "message": "生日快乐！",
    "time": "10:00",
    "days_before": 3,
    "channel": "openclaw-weixin",
    "to": "[email protected]"
  }
]

提醒消息格式：

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

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

openclaw cron-limited add \
  --every \x3Cduration> \
  --repeat \x3Ccount> \
  --message "\x3Ctext>" \
  [--channel \x3Cchannel>] \
  [--to \x3Cdestination>]

参数说明：

示例：

# 每5分钟提醒喝水，共3次
openclaw cron-limited add --every 5m --repeat 3 --message "记得喝水! 💧" \
  --channel openclaw-weixin --to "[email protected]"

模式2: 农历生日提醒

openclaw cron-limited add-lunar \
  --lunar \x3C月份-日期> \
  --message "\x3Ctext>" \
  [--time \x3CHH:MM>] \
  [--days-before \x3CN>] \
  [--yearly] \
  [--channel \x3Cchannel>] \
  [--to \x3Cdestination>]

参数说明：

示例：

# 农历8月15生日提醒（当天早上10点）
openclaw cron-limited add-lunar --lunar 8-15 \
  --message "🎂 生日快乐！" \
  --time 10:00 \
  --channel openclaw-weixin --to "[email protected]"

# 农历8月15，提前3天提醒
openclaw cron-limited add-lunar --lunar 8-15 \
  --message "🎂 记得准备好庆祝！" \
  --time 09:00 \
  --days-before 3 \
  --yearly \
  --channel openclaw-weixin --to "[email protected]"

# 春节提醒（农历正月初一）
openclaw cron-limited add-lunar --lunar 1-1 \
  --message "🧧 春节快乐！新的一年开始了！" \
  --time 08:00 \
  --yearly \
  --channel openclaw-weixin --to "[email protected]"

工作原理

有限次数重复

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