---

name: lunar-reminder description: 按农历日期设置提醒（生日、节日等）。当用户需要：(1) 按农历添加提醒事件 (2) 查看农历事件列表 (3) 农历日期与公历日期转换 (4) 设置农历生日/节日提醒 时使用此 skill。触发词：农历、农历生日、农历节日、阴历提醒。 metadata: openclaw: requires: bins: [] install: - id: lunar-javascript kind: node package: lunar-javascript label: 安装 lunar-javascript

Lunar Reminder

按农历日期设置提醒，支持生日、节日等重要日期的农历提醒。

数据文件

事件数据保存在：{{skillDir}}/data/events.json

Agent 工作流

1. 用户添加农历提醒

解析输入：从用户输入中提取事件名、农历月份、农历日期、提前天数（默认1）。

农历月份映射：

名称	数字
正月/正/一月	1
二月/杏月	2
三月/桃月	3
四月/槐月	4
五月/榴月	5
六月/荷月	6
七月/兰月	7
八月/桂月	8
九月/菊月	9
十月/露月	10
十一月/冬月/冬	11
十二月/腊月/腊	12

农历日期映射：

名称	数字
初一~初十	1~10
十一~二十	11~20
廿一/二十一~廿九/二十九	21~29
三十	30

执行步骤：

1. 读取现有事件（文件不存在则创建空数组）
2. 检查事件名是否已存在，存在则报错
3. 计算当年公历日期（运行下方命令）
4. 保存事件到文件
5. 确认添加成功

农历转公历命令（在 {{skillDir}} 目录执行）：

node -e "const {Lunar}=require('lunar-javascript');const l=Lunar.fromYmd(YEAR,MONTH,DAY);const s=l.getSolar();console.log(s.getYear()+'-'+String(s.getMonth()).padStart(2,'0')+'-'+String(s.getDay()).padStart(2,'0'));"

将 YEAR、MONTH、DAY 替换为实际值（如 2026, 2, 11）。

2. 用户查看提醒列表

读取 {{skillDir}}/data/events.json 文件，格式化输出每个事件的：

• 事件名
• 农历日期（月名+日名）
• 今年公历日期
• 提前提醒天数

3. 用户删除提醒

1. 读取事件文件
2. 过滤掉指定名称的事件
3. 保存文件
4. 删除对应 cron 任务：openclaw cron rm "lunar_<事件名>"

4. 用户要求日期转换

农历转公历：

cd {{skillDir}} && node -e "const {Lunar}=require('lunar-javascript');const l=Lunar.fromYmd(YEAR,MONTH,DAY);const s=l.getSolar();console.log(s.getYear()+'-'+String(s.getMonth()).padStart(2,'0')+'-'+String(s.getDay()).padStart(2,'0'));"

公历转农历：

cd {{skillDir}} && node -e "const {Solar}=require('lunar-javascript');const s=Solar.fromYmd(YEAR,MONTH,DAY);const l=s.getLunar();const m=['','正月','二月','三月','四月','五月','六月','七月','八月','九月','十月','冬月','腊月'];const d=['','初一','初二','初三','初四','初五','初六','初七','初八','初九','初十','十一','十二','十三','十四','十五','十六','十七','十八','十九','二十','廿一','廿二','廿三','廿四','廿五','廿六','廿七','廿八','廿九','三十'];console.log(m[l.getMonth()]+d[l.getDay()]);"

5. 用户要求同步提醒

1. 读取所有事件
2. 对每个事件：
   • 计算公历日期
   • 减去提前天数得到提醒日期
   • 执行 cron 命令

Cron 命令格式：

# 先删除旧任务
openclaw cron rm "lunar_<事件名>"

# 创建新任务
openclaw cron add --name "lunar_<事件名>" --cron "<分> <时> <日> <月> *" --message "🔔 农历提醒：<事件名>将在<N>天后到来" --tz "Asia/Shanghai"

数据格式

[
  {
    "name": "妈妈生日",
    "lunarMonth": 2,
    "lunarDay": 11,
    "lunarMonthName": "二月",
    "lunarDayName": "十一",
    "advanceDays": 1,
    "reminderTime": "09:00",
    "note": "",
    "createdAt": "2026-03-10T00:00:00.000Z"
  }
]

使用示例

添加农历提醒：妈妈生日，二月十一，提前1天提醒
查看所有农历提醒
删除农历提醒：妈妈生日
农历二月十一是公历几号
同步农历提醒到定时任务