๐ŸŽ Get the FREE AI Skills Starter Guide โ€” Subscribe โ†’
BytesAgainBytesAgain
๐Ÿฆ€ ClawHub

Reminder

by @fresh3

Capture natural-language events in Chinese or English, save them to your workspace, and schedule Telegram reminders with default 24h, 1h, and 10m notifications.

TERMINAL
clawhub install taizi-reminder

๐Ÿ“– About This Skill


name: reminder summary: Natural-language reminders โ†’ save to your workspace โ†’ schedule Telegram notifications (24h/1h/10m by default). description: Natural-language reminder secretary: capture events into git-synced workspace (data/logic separated), schedule Telegram reminders via OpenClaw cron, and answer "what's coming up" queries. Use when user mentions meetings, birthdays, deadlines, or asks for schedule/plans. tags: [reminder, schedule, cron, telegram, secretary]

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.