Skills cron-health-check

Monitors OpenClaw cron job health, identifies failures, timeouts, and delivery issues.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/austindixson/cron-health-check" ~/.claude/skills/openclaw-skills-cron-health-check && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/austindixson/cron-health-check" ~/.openclaw/skills/openclaw-skills-cron-health-check && rm -rf "$T"
manifest: skills/austindixson/cron-health-check/SKILL.md
source content

Cron Health Check | OpenClaw Skill

Description

Monitors OpenClaw cron job health, identifies failures, timeouts, and delivery issues.

Cron Health Check | OpenClaw Skill

Monitors the health of OpenClaw cron jobs by analyzing run history and identifying patterns of failures, timeouts, and delivery issues.

Usage

  • As a scheduled cron job to monitor job health proactively
  • Manually to check current cron job status
  • After fixing cron job errors to verify improvements
# Check health of all cron jobs (last 24 hours)
python3 /Users/ghost/.openclaw/workspace/skills/cron-health-check/scripts/check_cron_health.py

# Check last 48 hours
python3 /Users/ghost/.openclaw/workspace/skills/cron-health-check/scripts/check_cron_health.py --hours 48

# Output JSON format
python3 /Users/ghost/.openclaw/workspace/skills/cron-health-check/scripts/check_cron_health.py --json

What this skill does

  • Analyzes cron job run history from the last N hours
  • Identifies jobs with consecutive failures, timeouts, or delivery issues
  • Reports health status (healthy/warning/critical) for each job
  • Suggests fixes (e.g., adding --best-effort-deliver for delivery failures)
  • Detects OpenRouter API limit issues

Integration as a Cron Job

This skill can run periodically to monitor cron job health:

{
  "payload": {
    "kind": "agentTurn",
    "message": "Run cron-health-check skill to analyze cron job health.",
    "model": "openrouter/google/gemini-2.5-flash",
    "thinking": "low",
    "timeoutSeconds": 60
  },
  "schedule": {
    "kind": "cron",
    "cron": "0 */6 * * *"
  },
  "delivery": {
    "mode": "announce",
    "bestEffort": true
  },
  "sessionTarget": "isolated",
  "name": "Cron Health Monitor"
}

Output

Health status for each job:

  • healthy: No issues detected
  • warning: Some issues but not critical
  • critical: Multiple consecutive failures or timeouts

Issues detected:

  • Consecutive errors
  • Timeout patterns
  • Delivery failures (suggests --best-effort-deliver)
  • OpenRouter API limit exceeded

Exit Codes

  • 0
    : All jobs healthy
  • 1
    : Warning issues found
  • 2
    : Critical issues found