← Back to Skills Marketplace
carloscbrls

CC3PO System Healthcheck

by Carlos J Cabrales III · GitHub ↗ · v1.0.0 · MIT-0
macoslinux ⚠ suspicious
22
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cc3po-system-healthcheck
Description
Three-tier system health monitoring (L1/L2/L3) with heartbeat mechanism. Zero external dependencies, i18n support, console output only.
README (SKILL.md)

system-healthcheck

Three-tier system health monitoring for OpenClaw

English | 简体中文


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


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)
Usage Guidance
This skill looks suitable if you want local OpenClaw/system monitoring. Review the cron setup before enabling it, confirm log locations, verify the publisher/repository because metadata is inconsistent, and be careful with the manual `rm -rf` uninstall command.
Capability Analysis
Type: OpenClaw Skill Name: cc3po-system-healthcheck Version: 1.0.0 The system-healthcheck skill bundle is a legitimate monitoring tool designed to track system resources, service status, and file integrity within the OpenClaw environment. The Python scripts (l1_fast_check.py, l2_hourly_check.py, l3_daily_audit.py) use standard system commands like 'pgrep', 'systemctl', and 'shutil.disk_usage' to gather health metrics, all executed safely via subprocess lists to prevent injection. No evidence of data exfiltration, unauthorized persistence, or malicious prompt injection was found; the suggested crontab entries are transparently documented for the user to implement manually.
Capability Assessment
Purpose & Capability
The scripts and documentation align with system health monitoring, including disk, memory, cron, OpenClaw gateway, logs, and heartbeat checks. Some source content was truncated or omitted in the supplied artifact set, so confidence is medium rather than high.
Instruction Scope
Instructions ask the user to run local Python scripts and optionally add cron jobs. This is purpose-aligned for monitoring, but users should understand it creates recurring local checks.
Install Mechanism
No automatic install script is provided. Documentation includes manual install/uninstall commands, including a scoped rm -rf uninstall command. Metadata and version/owner references are somewhat inconsistent, which is a provenance note.
Credentials
The skill uses standard local system inspection commands and reads specific OpenClaw workspace files for health checks. This is proportionate to the stated monitoring purpose and no network exfiltration is shown.
Persistence & Privilege
The skill documents user-configured cron persistence for hourly, half-hourly, and daily checks. This is clearly disclosed and purpose-aligned, but should be reviewed before enabling.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cc3po-system-healthcheck
  3. After installation, invoke the skill by name or use /cc3po-system-healthcheck
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: L1/L2/L3 health checks, heartbeat mechanism, i18n support (en/zh-CN)
Metadata
Slug cc3po-system-healthcheck
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments