Reminder Engine

Turn natural-language reminders into OpenClaw cron jobs.

Workflow

1) Parse intent

Classify the request: - One-shot: “in 20 minutes”, “tomorrow at 9”, “on March 1st at 10:00” - Recurring: “every day at 9”, “every weekday at 10:30”, “every Monday”, “every 2 hours” - Management: “list reminders”, “cancel X”, “disable/enable”, “snooze X”

Extract: - reminder text (what should be said when it fires) - delivery channel context (current chat unless user specifies otherwise) - timezone (default to the runtime timezone unless user specifies)

2) Confirm schedule (always)

Before creating/updating/removing jobs, echo back: - the computed schedule in human form (and timezone) - whether it’s one-shot or recurring - the exact reminder message text

If the user’s wording is ambiguous (“next Friday”, “in the morning”), ask a single clarifying question.

3) Create the cron job (reminders)

Use the cron tool.

Rules: - Prefer schedule.kind="at" for one-shots. - Prefer schedule.kind="cron" for recurring reminders (use tz when possible). - Use sessionTarget="main" and payload.kind="systemEvent". - Write payload text like a reminder: start with “Reminder:” (especially if the reminder is set far in advance). - Include light context if it helps (“Reminder: submit the invoice (you said you need this for the client call)”).

4) List / cancel / snooze

• List: use cron.list, show jobId + next run + name/summary.
• Cancel: cron.remove(jobId) (prefer cancelling by exact jobId; if user provides text, search list and confirm).
• Snooze: implement as cancel+recreate (one-shot) or a one-shot override reminder.

Reminder text quality

• Keep it short and action-oriented.
• Avoid secrets.
• If the reminder is for a public channel, warn the user.

Safety

• Never create spammy recurring reminders without explicit confirmation.
• Never “broadcast” reminders to multiple targets unless explicitly requested.
• Never include access keys/tokens in reminder payloads.

Examples (what good looks like)

User: “remind me in 20 minutes to stretch” - Create one-shot at job. - Payload text: Reminder: stretch.

User: “every weekday at 10:30 remind me to stand up” - Create recurring cron job in local timezone. - Payload text: Reminder: stand up (weekday standup alarm).

User: “list my reminders” - List jobs; show ids so the user can say “cancel ”.

User: “cancel the stand up reminder” - List matching jobs, ask which one if multiple, then remove.