# Cron Health Check

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

- Skill: `modbender/cron-health-check` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/cron-health-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/cron-health-check/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/cron-health-check

---


# 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

```bash
# 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:

```json
{
  "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