Cron Helper Skill Purpose: Guides me to use openclaw cron CLI for time-based tasks and send logs on create/remove. When to use: User asks for periodic/reminder tasks User mentions "remind me every X" User needs scheduled background checks User wants agent to perform a task at a specific time Core Principle Always prefer cron over manual timing. Reason: I lack an internal clock. Manual "track time yourself" fails because I can get absorbed in reading/thinking and lose track of time. Cron is an external clock that works reliably. Main vs Isolated Session Isolated Session (RECOMMENDED for tasks) ✅ Best Practice Use --session isolated when you want the agent to actually perform a task : Agent receives the message and executes it Can use tools (exec, read, message, etc.) Can deliver output to a channel Does not pollute main conversation history Format: openclaw cron add \ --name "job_name" \ --cron "0 9 * * *" \ --session isolated \ --message "Task instructions for the agent" \ --deliver \ --channel feishu Main Session (simple notifications only) Use --session main with --system-event for simple notifications only : Just displays a message in main chat Agent does NOT execute any tasks No tool calls, no delivery Format: openclaw cron add \ --name "reminder" \ --at "+30m" \ --session main \ --system-event "Reminder: check email" How I Should Respond Step 1: Detect the request Keywords: "every", "remind", "schedule", "定时", "每小时/每天/每周", "在X分钟后执行" Step 2: Ask for details Get from user: What - task description or notification message When - schedule (e.g., "every 2 hours", "at 9am daily", "in 10 minutes") Delivery - does output need to be sent to a chat? (default: no) Name - job name (optional, auto-generated if not provided) Step 3: Create cron job For agent tasks (RECOMMENDED): openclaw cron add \ --name "task_name" \ --at "+10m" \ --session isolated \ --message "Your task instructions here" \ --deliver \ --channel feishu For simple reminders: openclaw cron add \ --name "reminder" \ --at "+10m" \ --session main \ --system-event "Your reminder message" Remove a cron job: openclaw cron rm < job_id

List all cron jobs: openclaw cron list Other useful commands: openclaw cron status

查看调度器状态

openclaw cron run < job_id

立即触发任务

openclaw cron enable < job_id

启用任务

openclaw cron disable < job_id

禁用任务

openclaw cron runs < job_id

查看执行历史

Delivery Options When using --session isolated , you can deliver output to a chat: Option Description --deliver Enable delivery (required for channel output) --channel Channel: feishu, telegram, slack, whatsapp, etc. --to Channel-specific target (chat ID, phone, etc.) --post-mode full Post full output instead of summary Examples:

Deliver to Feishu

--deliver --channel feishu

Deliver to Telegram

--deliver --channel telegram --to "-1001234567890"

Deliver with full output

--deliver --channel feishu --post-mode full Common Options Option Description --cron Cron expression (5-field or 6-field with seconds) --every Run every duration (e.g., 10m, 1h) --at Run once at time (ISO or +duration, supports m/s) --tz Timezone (default: local) --session main|isolated Target session (default: main) --system-event System event payload (main session only) --message Agent message payload (isolated session only) --delete-after-run Delete one-shot job after success --disabled Create job in disabled state Step 4: Send log On CREATE/REMOVE only: After creating or removing cron jobs, send ONE log with the exact command: Log format:

新增任务

[ HH:MM ] CRON ✅ $ openclaw cron add \ --name "job_name" \ --at "+10m" \ --session isolated \ --message "task description" \ --deliver \ --channel feishu

删除任务

[ HH:MM ] CRON ❌ $ openclaw cron rm < job_id

Examples:

新增

[ 21 :30 ] CRON ✅ $ openclaw cron add \ --name "daily-summary" \ --cron "0 9 * * *" \ --tz "Asia/Shanghai" \ --session isolated \ --message "总结今天的工作" \ --deliver \ --channel feishu

删除

[ 21 :41 ] CRON ❌ $ openclaw cron rm 983a0f0e-0976-414a-b3d0-fd09c533e301 Key points: Send log ONLY on create/remove, NOT on execution Keep it minimal: One command block, no extra text Cron → Human mapping (五位 - 分时日月周): /5 * * * * → 每5分钟 /30 * * * * → 每30分钟 0 * * * * → 每1小时 0 /2 * * * → 每2小时 0 9 * * * → 每天1次(09:00) 0 10,22 * * * → 每天2次(10:00,22:00) 0 9 * * 1 → 每周1次(周一09:00) Cron → Human mapping (六位 - 秒分时日月周): /1 * * * * * → 每1秒 /5 * * * * * → 每5秒 /30 * * * * * → 每30秒 Best Practice Summary Use Case Session Payload Delivery Agent performs task isolated --message --deliver ✅ Simple notification main --system-event ❌ Rule of thumb: If you want the agent to do something (use tools, send messages), use --session isolated + --message . What NOT To Do ❌ Don't say "I'll set a reminder myself" ❌ Don't try to track time manually ❌ Don't use --system-event when you need the agent to execute tasks ❌ Don't forget --deliver when you need output sent to chat ❌ Don't send execution logs (only log on create/remove) ✅ Always use the openclaw cron CLI ✅ Use --session isolated for agent tasks ✅ Use --session main for simple notifications only ✅ Send log on create/remove only ✅ Keep log simple and clean Common Schedule Patterns 五位 Cron（分 时 日 月 周） Frequency Cron Expression CLI Flag Every 5 min /5 * * * * --cron "/5 * * * " Every 30 min /30 * * * * --cron "/30 * * * " Every hour 0 * * * * --cron "0 * * * " Every 2 hours 0 /2 * * * --cron "0 /2 * * " Daily at 9am 0 9 * * * --cron "0 9 * * " Twice daily (10am, 10pm) 0 10,22 * * * --cron "0 10,22 * * " Weekly (Monday 9am) 0 9 * * 1 --cron "0 9 * * 1" 六位 Cron（秒 分 时 日 月 周） Frequency Cron Expression CLI Flag Every 1 second /1 * * * * * --cron "/1 * * * * " Every 5 seconds /5 * * * * * --cron "/5 * * * * " Every 30 seconds /30 * * * * * --cron "/30 * * * * *" Duration flags: Frequency CLI Flag Every 10 minutes --every "10m" Every 2 hours --every "2h" Once in 20 minutes --at "+20m" Once in 20 seconds --at "+20s" Loaded automatically when skill is installed.