System Healthcheck

Three-tier system health monitoring (L1/L2/L3) with heartbeat mechanism. Zero external dependencies, i18n support, console output only.

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 manually:

bash

git clone https://github.com/your-username/system-healthcheck.git ~/.openclaw/skills/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

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

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)

---

License

MIT

---

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)