Reminder

Reminder Skill

Create one-time reminder tasks using OpenClaw cron.

Usage

When user says "remind me to XXX in 30 seconds" or "remind me at 3pm", I create a cron job that executes the task and returns the result when the time comes.

Parameter Configuration

Fixed Parameters

Dynamic Parameters (from current session context)

Use session_status tool to get current session's deliveryContext:

How to get:

# Get current session info
session_status
Output contains deliveryContext:
{
  "channel": "discord",
  "to": "channel:1476104553148452958",
  "accountId": "machu"
}

Time Parsing

Parse user input time, support:

Convert to ISO 8601 format for cron.

Usage Example

User says "remind me to check weather in 30 seconds":

# 1. Get current session's deliveryContext
session_status
Assume output:
{
  "deliveryContext": {
    "channel": "discord",
    "to": "channel:1476104553148452958",
    "accountId": "machu"
  }
}
2. Calculate time 30 seconds later
date -u -d "+30 seconds" +"%Y-%m-%dT%H:%M:%SZ"
Result: 2026-02-26T13:30:00Z
3. Create cron job (using main session + system-event)
openclaw cron add \
  --name "reminder-weather" \
  --at "2026-02-26T13:30:00Z" \
  --session main \
  --system-event "Check Beijing weather" \
  --agent machu \
  --announce \
  --channel discord \
  --to "channel:1476104553148452958" \
  --delete-after-run

Task Content (SECURITY)

User-specified task content must be sanitized before passing to cron:

1. Validation Method: REJECT dangerous patterns (not escape) The script rejects any input containing: - Command substitution: $(), backticks ` ` - Shell metacharacters: ;, |, &, >, < - Double quotes: " (breaks CLI quoting) - Newlines: \n (can inject multiple commands) - Dangerous command prefixes: sudo, rm, wget, curl, bash, etc.

2. Sanitization Script: Use scripts/sanitize-message.sh to validate input:

   ./scripts/sanitize-message.sh "user's task content"
   # Exit code 0 = safe, non-zero = rejected
   

3. If rejected: Tell user the task contains invalid characters and ask them to rephrase without: $() ; | & > < " or dangerous commands.

Confirmation Reply

After creating the task, reply to user to confirm:

Notes

1. Time must be in the future, not the past 2. Task content should be concise and clear 3. If time exceeds 48 hours, suggest using calendar 4. Always use --session main + --system-event for reliable Discord delivery 5. Validate task content with sanitize-message.sh before creating job

When user says "remind me to XXX in 30 seconds" or "remind me at 3pm", I create a cron job that executes the task and returns the result when the time comes.

1. Time must be in the future, not the past 2. Task content should be concise and clear 3. If time exceeds 48 hours, suggest using calendar 4. Always use --session main + --system-event for reliable Discord delivery 5. Validate task content with sanitize-message.sh before creating job