CC3PO System Healthcheck
/install cc3po-system-healthcheck
system-healthcheck
Three-tier system health monitoring for OpenClaw
Features
- L1 Fast Check (\x3C200ms): Definition file existence check
- L2 Hourly Check (\x3C5s): System resources, services, logs
- L3 Daily Audit (\x3C60s): Comprehensive system audit
- Heartbeat Mechanism: Quiet when healthy, alert on issues
- i18n Support: Auto-detect language (en/zh-CN)
- Zero External Dependencies: Works out of the box
Installation
clawhub install system-healthcheck
Or install via OpenClaw:
openclaw skills install system-healthcheck
Quick Start
1. L1 Fast Check (Manual)
cd ~/.openclaw/skills/system-healthcheck
python scripts/l1_fast_check.py
2. L2 Hourly Check (Manual)
python scripts/l2_hourly_check.py
3. Setup Crontab
cat templates/crontab_example.txt
# Copy and edit crontab
crontab -e
4. Heartbeat Check
python scripts/heartbeat.py
Configuration
Edit config/default_config.yaml:
# Internationalization
i18n:
auto_detect: true # Auto-detect system language
# locale: zh-CN # Or specify manually
# Thresholds
thresholds:
disk_warning: 80 # Disk warning (%)
disk_critical: 95 # Disk critical (%)
memory_warning_mb: 500 # Memory warning (MB)
log_size_mb: 100 # Log size warning (MB)
# Heartbeat
heartbeat:
enabled: true
work_hours_start: 9
work_hours_end: 18
quiet_on_ok: true # Silent when all OK
Output Examples
L2 Hourly Check
🦞 System Health Check · 2026-03-23 09:00:00
✅ Disk Usage: 45% (threshold: 80%)
✅ Memory Usage: 1.2GB / 8GB
✅ Cron Service: Running
✅ OpenClaw Gateway: Healthy
✅ Log Files: 12MB
━━━━━━━━━━━━━━━━━━━━━━━━
✅ All checks passed
Duration: 1.2s
Heartbeat (All OK)
HEARTBEAT_OK
Heartbeat (Issues Detected)
🦞 Heartbeat Check · 2026-03-23 14:30:00
⚠️ Disk Usage: 85% (exceeds 80%)
✅ Memory Usage: 2.1GB / 8GB
...
Scripts
| Script | Purpose | Frequency |
|---|---|---|
l1_fast_check.py |
Definition files check | Before conversations |
l2_hourly_check.py |
System health check | Hourly (cron) |
l3_daily_audit.py |
Comprehensive audit | Daily 08:00 (cron) |
heartbeat.py |
Work-hours heartbeat | Every 30min (cron) |
CLI Options
# JSON output
python scripts/l2_hourly_check.py --json
# Quiet mode (exit code only)
python scripts/l2_hourly_check.py --quiet
# Force output (heartbeat)
python scripts/heartbeat.py --force
Exit Codes
0: All checks passed1: One or more checks failed
Internationalization
Supported languages:
en- Englishzh-CN- 简体中文
Auto-detected from system locale. Override with:
export OPENCLAW_LOCALE=zh-CN
python scripts/l2_hourly_check.py
Requirements
- Python 3.8+
- Linux or macOS
- No external dependencies (optional:
richfor colorful output,pyyamlfor config)
Contributing
Contributions welcome! Please read CONTRIBUTING.md first.
Changelog
v1.0.0 (2026-03-23)
- Initial release
- L1/L2/L3 checks
- Heartbeat mechanism
- i18n support (en/zh-CN)
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cc3po-system-healthcheck - After installation, invoke the skill by name or use
/cc3po-system-healthcheck - Provide required inputs per the skill's parameter spec and get structured output
What is CC3PO System Healthcheck?
Three-tier system health monitoring (L1/L2/L3) with heartbeat mechanism. Zero external dependencies, i18n support, console output only. It is an AI Agent Skill for Claude Code / OpenClaw, with 22 downloads so far.
How do I install CC3PO System Healthcheck?
Run "/install cc3po-system-healthcheck" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is CC3PO System Healthcheck free?
Yes, CC3PO System Healthcheck is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does CC3PO System Healthcheck support?
CC3PO System Healthcheck is cross-platform and runs anywhere OpenClaw / Claude Code is available (macos, linux).
Who created CC3PO System Healthcheck?
It is built and maintained by Carlos J Cabrales III (@carloscbrls); the current version is v1.0.0.