Reminders
You can create and manage time-based reminders for the user. Reminders are stored using the GoClaw scheduler and fire at the specified time.
Creating reminders
Use the cron_add tool to schedule reminders at specific times:
bash
# Reminder at a specific time today # cron format: minute hour day month weekday cron_add --id "rem-UNIQUE_ID" --schedule "0 15 14 2 *" --payload "📋 Lembrete: reunião com o cliente às 15h" # Daily reminder at 9am cron_add --id "daily-water" --schedule "0 9 * * *" --payload "💧 Hora de beber água! Mantenha-se hidratado." # Weekday reminder at 8:30am cron_add --id "standup" --schedule "30 8 * * 1-5" --payload "🏃 Daily standup em 30 minutos!" # Weekly reminder (every Monday at 10am) cron_add --id "weekly-review" --schedule "0 10 * * 1" --payload "📊 Hora da revisão semanal!" # Monthly reminder (1st of each month) cron_add --id "bills" --schedule "0 10 1 * *" --payload "💰 Verificar contas do mês"
Listing reminders
bash
cron_list
Removing reminders
bash
cron_remove --id "rem-UNIQUE_ID"
Date/time parsing guide
When the user says natural language, convert to cron:
| User says | Cron expression | Notes |
|---|---|---|
| "amanhã às 9h" | 0 9 DD MM * | Calculate tomorrow's date |
| "daqui a 2 horas" | Use sleep + background | Quick timer is better |
| "todo dia às 8h" | 0 8 * * * | Daily |
| "segunda a sexta 9h" | 0 9 * * 1-5 | Weekdays |
| "toda segunda" | 0 9 * * 1 | Weekly |
| "dia 15 de cada mês" | 0 9 15 * * | Monthly |
| "daqui a 30 minutos" | Use timer skill | Short-term = timer |
Tips
- •Generate unique IDs for reminders (e.g., "rem-" + timestamp or purpose).
- •For reminders less than 1 hour away, use the timer skill instead (simpler).
- •Always confirm the reminder time with the user before creating.
- •Use the user's timezone (from config or USER.md) when interpreting times.
- •Include a clear, descriptive message in the payload so the user understands the context.
- •For one-shot reminders, suggest removing them after they fire.
- •List existing reminders before creating duplicates.
Triggers
remind me, reminder, set a reminder, lembrete, me lembre, lembre-me amanhã, avise-me, agenda, scheduled reminder