4.6 KiB
4.6 KiB
name, description
| name | description |
|---|---|
| birthday-reminder | 管理家人/朋友生日提醒。农历或阳历生日,每年换算公历,生日前7天、前3天、当天通过钉钉+飞书双通道提醒杨轩。 |
生日提醒 skill
统一管理杨轩的家人/朋友生日提醒。支持农历或阳历生日,每年换算公历日期,在生日前7天、前3天、当天通过钉钉 + 飞书两个通道提醒杨轩。
触发场景
- 杨轩提供新的生日信息(农历或阳历)
- 需要查询/修改/删除某个人的生日提醒
- 需要为下一年设置生日提醒
成员生日库(记录于 MEMORY.md)
| 人物 | 生日类型 | 出生日期 | 说明 |
|---|---|---|---|
| 汪礼平 | 农历 | 1968年六月二十日 | 三次提醒 |
| 杨安顺 | 农历 | 1968年八月十八日 | 三次提醒 |
| 王芳 | 农历 | 1993年十月初七日 | 三次提醒 |
| 杨锦书 | 阳历 | 2021年11月10日 | 卷儿,阳历固定 |
换算规则
- 农历生日:每年农历日期对应的公历日期都不同,需要用 lunar_python 逐年换算
- 阳历生日:日期固定,不换算(如杨锦书每年都是11月10日)
农历换算命令(需要 lunar_python 已安装):
python3 -c "
from lunar_python import Lunar
for year in range(2026, 2031):
lunar = Lunar.fromYmd(year, 8, 18) # 月, 日(农历)
solar = lunar.getSolar()
print(f'{year}年农历8月18日 = 公历 {solar.getYear()}-{solar.getMonth():02d}-{solar.getDay():02d}')
"
提醒时间点计算
每年按公历生日计算三个提醒日,当天 0 点(UTC)触发:
- 前7天 = 生日 - 7天
- 前3天 = 生日 - 3天
- 当天 = 生日当天
创建 cron 任务(核心流程)
每个生日建3 对一次性 cron 任务(前7天/前3天/当天),每对含钉钉 + 飞书各一条。单条 cron 只能投一个渠道,双通道靠「孪生任务」实现。
投递目标(必须显式设置,否则不会推送):
- 钉钉:
--announce --channel dingtalk-connector --to 0464031658857345 - 飞书:
--announce --channel feishu --to oc_8eecfa0e1cc185c1cb19b4f3950cbc52(必须用私聊 chat_id;用用户 open_id 会被拒:Sending messages to users is temporarily unavailable) - 两条都加:
--session isolated --agent main --wake now --delete-after-run - 飞书任务
--name加后缀「(飞书)」,文案与钉钉版完全一致
命令模板(钉钉版;飞书版把 --channel/--to 换成上面飞书值,--name 加「(飞书)」):
cd /home/yangxuan/.openclaw && openclaw cron create "<UTC时间ISO>" \
--name "<姓名>生日提前7天" \
--message "🎂 提醒:<姓名>生日快到了!7天后<br>就是生日。" \
--agent main \
--session isolated --announce --channel dingtalk-connector \
--to "0464031658857345" --wake now --delete-after-run
一次建多条时写 python/shell 脚本循环调用(2026-09-17 用脚本一次建了 20 条飞书孪生任务),比逐条手敲快得多。
注意:--at 时间不带时区按 UTC 处理。北京时间 = UTC+8。
步骤
- 记录/更新生日信息到 MEMORY.md 的"🎂 生日提醒"区域
- 若农历生日,用 lunar_python 换算当年及下一年的公历日期;若阳历则固定
- 计算三个提醒日(前7天/前3天/当天)
- 为每年分别创建 3 对(共 6 条)一次性 cron 任务:钉钉 + 飞书各一条,isolated session,必须带
--agent main(多 agent 环境下无 owner 任务会让调度器卡死,阻塞所有提醒);投递只交给 delivery,禁止在--message/command 里手动调openclaw message send(CLI 不认识 dingtalk-connector,会失败) - 验证:用
openclaw cron list过滤「生日」,确认每个提醒日都有钉钉 + 飞书两条、effectiveAgentId=main、delivery.to 正确;"message send" 在整库应无残留 - 更新 MEMORY.md 记录已完成设置的年份
验证
创建后必须确认 delivery 已按渠道正确配置,否则提醒不会推送:
- 钉钉任务 →
dingtalk-connector:0464031658857345 - 飞书任务 →
feishu:oc_8eecfa0e1cc185c1cb19b4f3950cbc52(chat_id,非 open_id)
(main session 的 system-event 默认不投递,必须显式走 announce。)
注意事项
- 当年提醒时效:若当年提醒日已过,从下一年开始设置
- 任务为一次性,运行后自动删除;下一年需重新换算农历并新建
- 农历生日每年代入 lunar_python 换算公历日期(lunar_python 已通过
pip install --break-system-packages --user lunar_python安装)