--- name: set-reminder description: Use when user wants to be reminded about something at a specific time or recurring schedule. Creates cron-based reminders delivered via iMessage, Discord, or other configured channels. --- # Set Reminder Creates validated reminders using the OpenClaw cron system. Handles time parsing, channel validation, and delivers via configured channels. ## Usage From any workspace: ```bash python3 skills\/set-reminder\/scripts\/set_reminder.py --at --message "" [--channel ] python3 skills\/set-reminder\/scripts\/set_reminder.py --every --message "" [--channel ] python3 skills\/set-reminder\/scripts\/set_reminder.py --cron "" --message "" [--channel ] ``` Or using `{baseDir}` (skill directory): ```bash python3 {baseDir}\/scripts\/set_reminder.py --at --message "" [--channel ] python3 {baseDir}\/scripts\/set_reminder.py --every --message "" [--channel ] python3 {baseDir}\/scripts\/set_reminder.py --cron "" --message "" [--channel ] ``` ## Parameters | Parameter | Description | |-----------|-------------| | `--at` | One-shot: ISO datetime (`2025-02-01T14:00:00`) or relative (`+20m`, `+1h`, `+2d`) | | `--every` | Recurring interval: `30m`, `2h`, `1d` | | `--cron` | 5-field cron: `"0 9 * * *"` | | `--message` | Reminder text (required) | | `--channel` | Channel name from config (optional, uses default) | ## Examples ```bash # Remind in 20 minutes python3 skills\/set-reminder\/scripts\/set_reminder.py --at "+20m" --message "Take medicine" # Daily at 9 AM via discord python3 skills\/set-reminder\/scripts\/set_reminder.py --cron "0 9 * * *" --message "Standup" --channel discord # Every 2 hours python3 skills\/set-reminder\/scripts\/set_reminder.py --every "2h" --message "Drink water" ``` ## Config **Workspace\/local skill (recommended):** Create `config.json` in the skill directory: ```json { "default": "imessage", "timezone": "America\/Edmonton", "channels": { "imessage": "user@example.com", "discord": "1234567890123456789" } } ``` **Managed skill (legacy):** Config in `~\/.openclaw\/openclaw.json` at `skills.entries.set-reminder.config.`: ```json "set-reminder": { "enabled": true, "config": { "main": { "default": "imessage", "timezone": "America\/Edmonton", "channels": { "imessage": "user@example.com" } } } } ``` **Required fields:** `default`, `timezone`, `channels` ## How It Works 1. Loads config from skill directory (workspace\/local) or managed skill location 2. Validates input (time format, channel exists) 3. Creates cron job via `openclaw cron add` 4. Reminder fires and delivers via configured channel **Config Priority:** 1. `\/config.json` (workspace\/local skill - highest priority) 2. `~\/.openclaw\/skills\/set-reminder\/config.json` (managed skill) 3. `~\/.openclaw\/openclaw.json` at `skills.entries.set-reminder.config` (legacy fallback)