openclaw-workspace/memory/projects/discord-reminder-system.md

Discord Reminder System

Status: ✅ Live
Channel: #schedule (1474636036905631867)
Created: 2026-02-25
Files:

• tools/reminder-manager.py - Core Python logic
• tools/reminder-handler.ps1 - PowerShell wrapper
• skills/discord-reminder/SKILL.md - Documentation
• data/reminders.db - SQLite database

How It Works

1. User says: remind me 20m Call John
2. I parse natural language time (20m, 2h, tomorrow 9am, etc.)
3. Create OpenClaw cron job for exact time
4. At trigger time, cron fires → sends Discord message
5. One-shot jobs auto-delete after firing

Supported Time Formats

Format	Example
Minutes	20m, 5m
Hours	2h, 1h30m
Today time	9am, 2:30pm, 15:00
Tomorrow	tomorrow, tomorrow 9am

Commands

• remind me [time] [message] - Add reminder
• list reminders - Show active reminders
• cancel reminder #[id] - Cancel by ID

Technical Details

• Backend: OpenClaw cron + SQLite
• Delivery: systemEvent → Discord channel
• Timezone: America/Chicago (automatic DST handling)
• Cleanup: Old reminders auto-delete via Daily Cron Cleanup job

Testing History

• ✅ 2026-02-25 - Basic 5m reminders working
• ✅ 2026-02-25 - 3pm same-day reminders working
• ✅ 2026-02-27 - Confirmed still working after 2 days

Known Quirks

• Must say "remind me" — "remind 4 minutes" won't work (by design)
• One-shot reminders don't show in list after firing (auto-deleted)
• All times are America/Chicago

Future Ideas

• Recurring reminders (daily, weekly)
• Snooze functionality
• Reminder categories/tags
• DM reminders (vs channel-only)