openclaw-workspace/skills/discord-reminder/SKILL.md

name, description, emoji

name	description	emoji
discord-reminder	Discord Reminder System - Schedule one-time reminders via natural language commands	🔔

Discord Reminder System

Schedule and manage reminders in Discord channels.

Commands

/remind - Add a reminder

Add a one-time reminder with natural language time.

Time formats:

• 20m, 2h, 1h30m — Relative time from now
• 9am, 2:30pm, 15:00 — Today at that time (or tomorrow if past)
• tomorrow 9am — Tomorrow at time
• tomorrow — Tomorrow at same time

Examples:

/remind 20m Call John
/remind 2h Check email
/remind 9am Team standup
/remind tomorrow 9am Dentist appointment

/reminders - List your reminders

Show all active upcoming reminders.

Example:

/reminders

Output:

#1: Call John - Feb 21 at 2:30 PM
#3: Dentist appointment - Mar 3 at 9:00 AM

/remind cancel <id> - Cancel a reminder

Remove a reminder by its ID.

Example:

/remind cancel 2

Implementation Notes

The reminder system uses:

1. SQLite database at ~/.openclaw/workspace/data/reminders.db
2. OpenClaw cron for scheduling - when a reminder is added, a one-shot cron job is created
3. Auto-cleanup - old reminders are deleted after firing

How It Works

1. User says: "remind me 20m to call John"
2. OpenClaw parses the natural language
3. Creates DB entry with user_id, channel_id, message, remind_at
4. Schedules OpenClaw cron job for that exact time
5. At trigger time, OpenClaw sends reminder message to channel
6. Reminder marked inactive in DB

Timezone

All times are America/Chicago (Corey's timezone). The system handles DST automatically.