OpenClaw Reminder

Use OpenClaw's native cron tool as the primary way to create and manage chat reminders. The bundled scripts/reminder_cron.py helper is optional and should be treated as a convenience layer, not the core contract of the skill.

Use this skill for

• creating a one-time reminder
• listing pending reminder jobs
• reviewing reminders due soon
• checking overdue reminder jobs that still exist
• canceling an unexecuted reminder

Do not use this skill for

• calendar event management
• third-party reminder services
• recurring habits unless the user explicitly wants a recurring cron reminder

Core workflow

1. For a new reminder, create a one-shot cron job with schedule.kind="at", payload.kind="systemEvent", and reminder text that will still make sense when it fires later.
2. Name reminder jobs with a stable reminder: prefix so they can be found and managed later.
3. Set deleteAfterRun=true for ordinary one-time reminders.
4. When the reminder must return to the same chat, include explicit delivery routing only when the active channel requires it.
5. To inspect reminders, list cron jobs and filter reminder jobs by name and schedule.
6. To cancel a reminder that has not fired yet, identify the correct reminder job first, then remove only that job.

Native cron tool examples

Create a one-time reminder:

{
  "name": "reminder:doctor-appointment",
  "schedule": {
    "kind": "at",
    "at": "2026-04-26T14:00:00+08:00"
  },
  "payload": {
    "kind": "systemEvent",
    "text": "Reminder: leave now for your appointment."
  },
  "delivery": {
    "mode": "announce"
  },
  "deleteAfterRun": true
}

Inspect reminders:

• list cron jobs and filter jobs whose names start with reminder:
• for due-soon views, compare schedule times against the requested window
• for overdue views, show reminder jobs whose scheduled time has already passed but still exist

Cancel a reminder:

• find the intended reminder: job first
• remove only the confirmed target job

Optional helper script

Use scripts/reminder_cron.py only when a local CLI helper is actually useful in the current environment. This helper is primarily suited to environments where the OpenClaw CLI is available and the active reminder route is backed by a supported chat channel plugin with explicit delivery fields. Treat it as an environment-dependent convenience layer, not as a guaranteed cross-channel or cross-version contract; in other environments, it may require adjustment or may not work directly.

python3 scripts/reminder_cron.py create --title "Doctor appointment" --at "2026-04-26 14:00" --tz UTC --channel <channel> --to <target> --account <account>
python3 scripts/reminder_cron.py pending
python3 scripts/reminder_cron.py upcoming --days 3
python3 scripts/reminder_cron.py overdue
python3 scripts/reminder_cron.py delete --id <job_id>

Delivery guidance