version: "1.0.0" name: reminder description: "[DEPRECATED — use the 'board' skill instead] Set, list, and cancel reminders" user-invocable: false triggers: [] scripts: run: "scripts/run.ts" inputSchema: type: object properties: action: type: string enum: [set, list, cancel] description: "Action to perform: set a new reminder, list active reminders, or cancel one" time: type: string description: "When to trigger (for 'set', one-time only). Examples: '5 minutes', 'at 10am', 'tomorrow at 9am'" message: type: string description: "The exact user-facing reminder text (for 'set'). Address the user directly; never write internal instructions such as 'ask the user' or 'send a message'." recurring: type: object description: "For recurring reminders (for 'set'). If set, 'time' is ignored." properties: type: type: string enum: [daily, weekly, weekdays, weekends] hour: type: integer description: "Hour in 24h format (0-23)" minute: type: integer description: "Minute (0-59)" dayOfWeek: type: integer description: "Day of week (0=Sunday, 6=Saturday). Only for type 'weekly'." reminder_id: type: string description: "Reminder ID to cancel (for 'cancel')" required: [action] metadata: openclaw: emoji: "\u23F0" safety: localWrite: true requires: bins: []

Reminder Skill

Set reminders that trigger messages back to the user at specified times.

When to Use

Use the reminder skill for:

• One-time reminders: "remind me to call mom in 30 minutes"
• Scheduled reminders: "remind me at 3pm to take medicine"
• Tomorrow reminders: "remind me tomorrow at 9am about the meeting"
• Recurring reminders: "remind me every day at 10am to check email"
• Managing reminders: List or cancel existing reminders

Input Format

The skill accepts JSON arguments via the SKILL_ARGS environment variable:

{
  "action": "set",
  "time": "in 30 minutes",
  "message": "Call mom"
}

Parameters

The message is delivered verbatim. Write the notification itself, not a plan for another agent:

• BAD: Ask the user whether the report is finished
• GOOD: Hey, is the report finished?

Time Format Examples

Intervals:

• 5 minutes, 30 min, 1 hour, 2 hours

Absolute times:

• at 10am, at 3:30pm, at 14:00
• tomorrow at 9am, tomorrow at 3pm

Recurring (use the `recurring` object instead of `time`):

• { "type": "daily", "hour": 10, "minute": 0 }
• { "type": "weekly", "hour": 9, "minute": 0, "dayOfWeek": 1 } (Monday)
• { "type": "weekdays", "hour": 8, "minute": 0 }
• { "type": "weekends", "hour": 10, "minute": 0 }

Output Format

{
  "success": true,
  "output": "Reminder set! I'll remind you \"Call mom\" in 30 minutes. Next trigger: Mon, Jan 20 at 3:30 PM. ID: abc123",
  "exitCode": 0
}

Examples

Set a one-time reminder

{
  "action": "set",
  "time": "in 30 minutes",
  "message": "Take a break"
}

Set a reminder for specific time

{
  "action": "set",
  "time": "tomorrow at 8am",
  "message": "Bring milk"
}

Set a recurring reminder

{
  "action": "set",
  "recurring": { "type": "daily", "hour": 10, "minute": 0 },
  "message": "Stand up and stretch"
}

List active reminders

{
  "action": "list"
}

Cancel a reminder

{
  "action": "cancel",
  "reminder_id": "abc123"
}