Introduction
# Reminder (secretary)
A lightweight personal secretary for OpenClaw: - Tell it events in natural language (Chinese/English). - It extracts structured info and stores it in your workspace (so Git/`claw-roam` can sync across devices). - It schedules Telegram reminders using OpenClaw `cron`.
## What it does
- Capture events from chat (meetings / birthdays / deadlines) - Store events in a **workspace data file** (easy to back up & sync via Git/`claw-roam`) - Schedule Telegram reminders using OpenClaw `cron` - Answer queries like “我最近有什么安排/计划？”
## Data (separated from skill)
This skill contains **no personal event data**.
User data lives in the workspace at: - Events file: `~/.openclaw/workspace/reminders/events.yml`
Template (shipped with the skill): - `skills/reminder/assets/events.template.yml`
## Config (env)
- `REMINDER_TZ` (default: `Asia/Shanghai`) - `REMINDER_OFFSETS_MINUTES` (default: `1440,60,10` for 24h/1h/10m)
## Capture behavior
When user says something like: - “后天上午10点有个会” - “下个月2号我妈生日” - “周五下午三点交报告”
Do: 1) Parse the event: - title - start datetime (Shanghai) - notes (optional) - reminders offsets (default 24h/1h/10m) - repeat (optional: yearly/monthly/weekly) 2) If key info is ambiguous (e.g. ‘后天’ date, ‘下个月’ which month, lunar birthday conversion, time missing), ask **only the minimal** clarifying question(s). 3) Write/update the event in `reminders/events.yml`. 4) Create `cron` jobs for each reminder time (delivery to current Telegram).
## Reply style
- After scheduling: reply briefly with the resolved datetime + confirmation. - For cancellations/changes: confirm what was changed and whether cron jobs were removed/replaced.
## Queries
If user asks: - “我最近有什么安排？” - “下周有什么？”
Then read `reminders/events.yml`, compute upcoming items (Shanghai time), and summarize.
## Notes / safety
- Never commit machine-specific secrets (keep them in `LOCAL_CONFIG.md`, already gitignored). - For lunar birthdays: store the canonical lunar date + the computed solar date for the target year; ask how to handle leap months when needed.