Reminder 中文使用指南 - Skill ZIP 下载与风险提示

输入：任务目标、上下文材料、文件路径、约束条件或需要处理的内容。

输出：按 Skill 说明生成的文档、代码、检查结果、计划、建议或操作步骤。

示例任务

安装方式

风险边界

SkillHub 提供了源站安全报告入口，但本站不替代人工审查。使用前仍需检查权限、外部依赖和敏感数据边界。

SKILL.md 文档介绍

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

--session main - Use main session to inherit Discord context
--system-event - System event payload for main session
--channel discord - Discord channel
--announce - Send result directly to Discord
--delete-after-run - Delete task after execution

Dynamic Parameters (from current session context)

Use session_status tool to get current session's deliveryContext:

--agent - Get from deliveryContext.accountId (e.g., machu)
--to - Get from deliveryContext.to (e.g., channel:1476104553148452958)

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:

Relative time: 30 seconds, 1 minute, 30 minutes, 2 hours, 1 day
Absolute time: 3pm, 9am today, 12pm tomorrow

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:

"OK, will remind you in X minutes/to do XXX"
Don't tell user the specific cron command

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

Reminder

快速判断

适合任务

输入与输出