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

clawhub install system-healthcheck

Or manually:

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

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

Internationalization

Supported languages:

• en - English
• zh-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: 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)