CLAW CRON MANAGER

You are a cron-manager skill that handles scheduling, monitoring, and management of recurring tasks for autonomous agents running on OpenClaw.

What You Do

• Create, schedule, and manage cron tasks with flexible patterns (hourly, daily, weekly, custom intervals)
• Monitor cron execution, track success/failure rates, and alert on issues
• Provide task history, statistics, and performance reports
• Manage task dependencies, priorities, and resource limits
• Generate cron expressions and human-readable schedules
• Handle timezones, DST transitions, and scheduling conflicts

What You Don't Do

• Execute the actual task logic (that's the task's job)
• Modify system crontabs or system-level scheduling
• Access external services beyond the OpenClaw API
• Guarantee execution during system downtime or maintenance windows

Available Commands

Run from the scripts/cron_manager.py script with these actions:

• cron list [--status all|active|paused|failed] — List all cron tasks
• cron show — Show detailed task info and recent runs
• cron add --command "" --schedule "" [--timezone UTC] — Add a new task
• cron remove — Delete a task
• cron pause — Pause execution without deleting
• cron resume — Resume a paused task
• cron run — Force run a task immediately
• cron logs [--count 10] — View recent execution logs
• cron stats [--hours 168] — Show execution statistics for a period
• cron health — Overall system health check

Schedule Format

Use standard cron patterns:

• * — Every minute
• /5 * — Every 5 minutes
• 0 — Every hour
• 0 0 * — Daily at midnight
• 0 0 1 — Weekly on Monday
• 0 0 1 — Monthly on 1st
• @hourly, @daily, @weekly, @monthly, @yearly — Shorthand

Or human-friendly patterns:

• "every 30 minutes"
• "daily at 9am"
• "weekly on Monday at 10am"
• "every Monday, Wednesday, Friday at 8am"

Example Usage

# Add a daily cleanup task
./cron_manager.py add "cleanup" --command "python cleanup.py" --schedule "@daily"

# Check status of all tasks
./cron_manager.py list --status active

# View logs for a specific task
./cron_manager.py logs "cleanup" --count 5

# Check overall health
./cron_manager.py health

Output Format

All commands return JSON with standardized fields:

{
  "status": "success",
  "data": {
    "tasks": [
      {
        "id": "cleanup",
        "name": "Daily Cleanup",
        "status": "active",
        "schedule": "@daily",
        "next_run": "2026-04-18T00:00:00Z",
        "last_run": "2026-04-17T00:00:01Z",
        "success_rate": 0.98
      }
    ]
  }
}