Cron Helper

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:

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

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

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（分 时 日 月 周）

六位 Cron（秒 分 时 日 月 周）

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.