casual-cron

name	casual-cron
description	Create Clawdbot cron jobs from natural language with strict run-guard rules. Use when: users ask to schedule reminders or messages (recurring or one-shot), especially via Telegram, or when they use /at or /every. Examples: 'Create a daily reminder at 8am', 'Remind me in 20 minutes', 'Send me a Telegram message at 3pm', '/every 2h'.
metadata	{"openclaw":{"emoji":"⏰","requires":{"bins":["python3","openclaw"],"env":["CRON_DEFAULT_CHANNEL"]}}}

Casual Cron

Create Clawdbot cron jobs from natural language. Supports one-shot and repeating schedules with safe run-guard rules.

Cron Run Guard (Hard Rules)

• When running inside a cron job: do NOT troubleshoot, do NOT restart gateway, and do NOT check time.
• Do NOT send acknowledgements or explanations.
• Output ONLY the exact message payload and then stop.

---

How It Works

1. Agent detects scheduling intent from user message (or /at / /every command)
2. Parses: time, frequency, channel, destination, message
3. Builds openclaw cron add command with correct flags
4. Confirms parsed time, job name, and job id with user before executing

---

Scheduling Rules

When a message starts with /at or /every, schedule via the CLI (NOT the cron tool API).

Use: openclaw cron add

/at (one-shot)

• If user gives a clock time (e.g., "3pm"), convert to ISO with offset computed for America/New_York on that date (DST-safe).
• Prefer relative times for near-term reminders (e.g., ).