介绍
# Reminder (secretary)
OpenClaw 的轻量级个人秘书： - 用自然语言（中文/英文）告知事件。 - 它会提取结构化信息并存储在工作区中（以便 Git/`claw-roam` 跨设备同步）。 - 使用 OpenClaw `cron` 安排 Telegram 提醒。
## 功能
- 从聊天中捕获事件（会议 / 生日 / 截止日期） - 将事件存储在 **工作区数据文件** 中（便于通过 Git/`claw-roam` 备份与同步） - 使用 OpenClaw `cron` 安排 Telegram 提醒 - 回答诸如“我最近有什么安排/计划？”之类的查询
## 数据（与技能分离）
本技能 **不包含任何个人事件数据**。
用户数据存放在工作区： - 事件文件：`~/.openclaw/workspace/reminders/events.yml`
模板（随技能提供）： - `skills/reminder/assets/events.template.yml`
## 配置 (env)
- `REMINDER_TZ`（默认：`Asia/Shanghai`） - `REMINDER_OFFSETS_MINUTES`（默认：`1440,60,10`，对应 24h/1h/10m）
## 捕获行为
当用户说类似以下的话时： - “后天上午10点有个会” - “下个月2号我妈生日” - “周五下午三点交报告”
执行： 1) 解析事件： - 标题 - 开始时间（上海时区） - 备注（可选） - 提醒偏置（默认 24h/1h/10m） - 重复（可选：yearly/monthly/weekly） 2) 如果关键信息不明确（例如“后天”的日期、“下个月”指哪个月、农历生日转换、缺少时间），仅提出 **最少必要** 的澄清问题。 3) 在 `reminders/events.yml` 中写入或更新事件。 4) 为每个提醒时间创建 `cron` 任务（投递到当前 Telegram）。
## 回复风格
- 安排后：简要回复确认的日期时间与确认信息。 - 对于取消/更改：确认已更改的内容以及 cron 任务是否已删除/替换。
## 查询
如果用户询问： - “我最近有什么安排？” - “下周有什么？”
则读取 `reminders/events.yml`，计算即将到来的项目（上海时间），并汇总。
## 备注 / 安全
- 永远不要提交特定于机器的密钥（将它们保存在 `LOCAL_CONFIG.md` 中，该文件已被 gitignore）。 - 对于农历生日：存储规范农历日期 + 目标年份的推算阳历日期；必要时询问如何处理闰月。