System Healthcheck

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

Security Scan

The skill's code, instructions, and requirements are consistent with a local system-healthcheck: it inspects local files, system services and resources, and suggests crontab/initialization integration; it does not request secrets or reach out to external endpoints.

Purpose & Capability

Name/description (three-tier health checks, heartbeat, i18n, console output) match the shipped scripts: l1/l2/l3/heartbeat and i18n; required tools (systemctl/pgrep/lsof) and reading local files are appropriate for a monitoring tool.

Instruction Scope

Runtime instructions and scripts operate on local system state (workspace files like SOUL.md, /proc/meminfo, systemctl/pgrep/lsof). This is within the stated purpose, but INSTALL.md suggests adding an automatic L1 invocation into OpenClaw's session init and configuring crontab — these are legitimate for monitoring but will cause the agent/host to run checks automatically and require the user to edit host configuration.

Install Mechanism

No install spec is provided (instruction-only), installation is via clawhub or manual git clone as documented. No remote installers, URL shorteners, or archive extraction are used in the metadata.

Credentials

The skill requests no credentials or privileged environment variables. It optionally reads OPENCLAW_LOCALE and uses common environment vars for PATH/personal dirs in crontab examples; these are proportional to i18n and local configuration.

Persistence & Privilege

The skill does not request 'always:true' or modify other skills, but documentation instructs adding crontab entries and (optionally) injecting an L1 subprocess call into OpenClaw session initialization. Those changes give it persistent automatic execution on the host if the user applies them — expected for a healthcheck but worth user awareness.

Assessment

This package appears coherent for local health monitoring, but review and sanity-check before installing: 1) Inspect the scripts (they run local commands, read ~/.openclaw/workspace files and /proc, and call system utilities like systemctl/pgrep/lsof). 2) Run ./scripts/test.sh manually in a safe environment first (non-production) to see outputs. 3) If you don't want automatic runs, do NOT add the suggested code to your OpenClaw session-init or crontab; instead run checks manually. 4) No network endpoints or secrets are requested, but verify you trust the source before cloning into ~/.openclaw/skills. 5) Optional: audit the l2/l3 scripts (full l3 content truncated in scan) if you need assurance they don't execute unexpected commands on your system.

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

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