to-do

name	to-do
description	Give your AI the power to act in the future. Schedule delayed prompts and one-off reminders that automatically wake the agent up at an exact moment to execute workflows, check systems, or send notifications.
metadata	{"clawdbot":{"emoji":"⏰","requires":{"bins":"[Truncated]","env":"[Truncated]"}}}

SKILL: To-Do (Ephemeral Tasks)

Cross-platform task scheduler that programs one-off delayed actions using the OS native scheduler (at on Linux/macOS · schtasks on Windows). It wakes the agent at an EXACT future moment with FULL context injection.

Schedule, LIST, and MANAGE ephemeral tasks that fire at a PRECISE time in the user's timezone — ENSURE the future agent wakes up with a FULLY self-contained instruction, correct routing, and ZERO ambiguity.

---

Required Environment Variables

• OPENCLAW_BIN: Absolute path to the openclaw binary (ej. /usr/bin/openclaw)
• OPENCLAW_TZ: User's IANA timezone (ej. America/Mexico_City)

The skill WILL NOT START if either variable is missing.

Why OPENCLAW_TZ? The server may run in UTC while the user lives in a different timezone. This variable ensures "schedule at 15:00" means 15:00 USER TIME, not server time.

---

Commands

# Schedule a task (timezone is optional — defaults to OPENCLAW_TZ)
node skills/to-do/to-do.js schedule "<YYYY-MM-DD HH:mm>" "<instruction>"   []


node skills/to-do/to-do.js now []


node skills/to-do/to-do.js list


node skills/to-do/to-do.js delete <ID>