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

重要：处理每日自动检查

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

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

bash
openclaw agent --message <提醒消息> --deliver --channel --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 \
--repeat \
--message \
[--channel ] \
[--to ]

参数说明：

参数	必须	说明
--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 \
[--time ] \
[--days-before ] \
[--yearly] \
[--channel ] \
[--to ]

参数说明：

参数	必须	说明
--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. 1. 创建主任务（循环任务）
2. 根据 --every 和 --repeat 计算第N次的执行时间
3. 在第N次执行时间 + 1分钟 创建「删除主任务」的一次性任务
4. 主任务执行第N次后，下一分钟自动被删除

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

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

---

依赖

• - Python 3 + lunarcalendar 库
• openclaw CLI
• jq