system-healthcheck#

Three-tier system health monitoring for OpenClaw

English | 简体中文

---

Features#

• L1 Fast Check (<200ms): Definition file existence check
• L2 Hourly Check (<5s): System resources, services, logs
• L3 Daily Audit (<60s): 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#

bash

clawhub install system-healthcheck

Or install via OpenClaw:

bash

openclaw skills install system-healthcheck

---

Quick Start#

1. L1 Fast Check (Manual)#

bash

cd ~/.openclaw/skills/system-healthcheck
python scripts/l1_fast_check.py

2. L2 Hourly Check (Manual)#

bash

python scripts/l2_hourly_check.py

3. Setup Crontab#

bash

cat templates/crontab_example.txt
# Copy and edit crontab
crontab -e

4. Heartbeat Check#

bash

python scripts/heartbeat.py

---

Configuration#

Edit config/default_config.yaml:

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#

text

🦞 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)#

text

HEARTBEAT_OK

Heartbeat (Issues Detected)#

text

🦞 Heartbeat Check · 2026-03-23 14:30:00

⚠️ Disk Usage: 85% (exceeds 80%)
✅ Memory Usage: 2.1GB / 8GB
...

---

Scripts#

ScriptPurposeFrequencyl1_fast_check.pyDefinition files checkBefore conversationsl2_hourly_check.pySystem health checkHourly (cron)l3_daily_audit.pyComprehensive auditDaily 08:00 (cron)heartbeat.pyWork-hours heartbeatEvery 30min (cron)

---

CLI Options#

bash

# 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 passed
• 1: One or more checks failed

---

Internationalization#

Supported languages:

• en - English
• zh-CN - 简体中文

Auto-detected from system locale. Override with:

bash

export OPENCLAW_LOCALE=zh-CN
python scripts/l2_hourly_check.py

---

Requirements#

• Python 3.8+
• Linux or macOS
• No external dependencies (optional: rich for colorful output, pyyaml for 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)