cron-limited

# 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