Introduction
# Quick Reminders
One-shot reminders for **< 2 days ahead**. Agent composes the final delivery text at creation time. At fire time a background process sends it via `openclaw message send` — zero LLM tokens.
## Guardrail — 2+ days? Use calendar instead
If the user asks for a reminder **2 or more days from now**, do NOT use this skill. Instead, create a calendar event (if the user has a calendar or an appropriate skill is available) with an appropriate reminder notification. Explain briefly: "I'll add it to your calendar with a reminder so it won't be lost."
---
All operations go through the CLI: `bash {baseDir}/scripts/nohup-reminder.sh <command> [args]`
> If `{baseDir}` is not resolved, use workspace-relative: `bash ./skills/quick-reminders/scripts/nohup-reminder.sh <command> [args]`
`--target`: Delivery target from TOOLS.md (§ Reminders). Required for `add`. Format depends on channel (e.g. Telegram chat ID, WhatsApp E.164 number, Discord channel ID). If missing in TOOLS.md — check `session_status` tool for `deliveryContext.to` (strip channel prefix like `telegram:`), save to TOOLS.md, and use it.
**Channel:** Telegram by default. Override with `--channel <name>` (e.g. `whatsapp`, `discord`, `signal`, `imessage`).
---
## Commands
### Add ``` nohup-reminder.sh add "Reminder text here" --target <chat_id> -t TIME [--channel CH] [-z TIMEZONE] ``` - Text: the **exact message** the user will receive. Compose it yourself — keep your voice, add a CTA or helpful note when relevant. - `-t`: relative (`30s`, `20m`, `2h`, `1d`, `1h30m`) or absolute ISO-8601 (`2026-02-07T16:00:00+03:00`) - `-z`: IANA timezone for naive absolute times (default: system local)
### List ``` nohup-reminder.sh list ``` Auto-prunes fired entries.
### Remove ``` nohup-reminder.sh remove ID [ID ...] nohup-reminder.sh remove --all ```
---
## Composing the reminder message
The reminder should feel like a **friend texting you**, not a system notification. No robotic phrasing.
**Never:** - "Reminder: call John" - "This is your reminder to..." - "You asked to be reminded about..." - "Task: load dishwasher"
**Instead — sound human:** - "Hey, you wanted to call John" - "Time to call John back" - "So... dishwasher time" - "I know you hate it, but the dishwasher won't load itself" - "Package is waiting — go grab it"
**Guidelines:** - Use casual openers: "Hey", "So...", "Heads up", "{UserName}", or just dive in - Okay to add light humor or empathy when it fits ("I know, I know...") - Keep it short — one line, no formalities - The user reads this out of context hours later; it should still make sense
---
## Examples (copy-paste ready, replace `<chat_id>` with actual ID)
User: "Remind me to call John in 2 hours" ```bash bash {baseDir}/scripts/nohup-reminder.sh add "Hey, you wanted to call John" --target <chat_id> -t 2h ```
User: "Remind me in 20 minutes to grab the laundry" ```bash bash {baseDir}/scripts/nohup-reminder.sh add "Laundry's ready — go grab it" --target <chat_id> -t 20m ```
User: "Set a reminder for today at 6pm — pick up the package" ```bash bash {baseDir}/scripts/nohup-reminder.sh add "Package is waiting for you" --target <target> -t "2026-02-07T18:00:00" -z "America/New_York" ```
User: "Remind me via WhatsApp in 30 min to check the oven" ```bash bash {baseDir}/scripts/nohup-reminder.sh add "Check the oven!" --target +15551234567 -t 30m --channel whatsapp ```
User: "What reminders do I have?" ```bash bash {baseDir}/scripts/nohup-reminder.sh list ```
User: "Cancel reminder #3" ```bash bash {baseDir}/scripts/nohup-reminder.sh remove 3 ```
User: "Cancel reminders 1 and 4" ```bash bash {baseDir}/scripts/nohup-reminder.sh remove 1 4 ```
User: "Clear all my reminders" ```bash bash {baseDir}/scripts/nohup-reminder.sh remove --all ```
---
## Rules
1. **Compose the delivery text yourself at creation time.** No LLM runs when it fires. 2. Text must make sense to the user out of context. 3. Confirm with **one short word/phrase** — e.g. "Will do", "Will remind you", "Got it", in future tense. Not "Done", "Added", "Created", "Reminder X is set for Y". No IDs, no times, no details. 4. To change: remove old, then add new.