system-healthcheck

OpenClaw 三层系统健康监控方案

English | 简体中文

特性

• L1 快速检查（<200ms）：校验定义文件是否存在
• L2 每小时检查（<5s）：系统资源、服务状态、日志情况
• L3 每日审计（<60s）：全面系统审计
• 心跳机制：健康时静默，异常时告警
• i18n 支持：自动检测系统语言（en/zh-CN）
• 零外部依赖：开箱即用

安装

clawhub install system-healthcheck

或通过 OpenClaw 安装：

openclaw skills install system-healthcheck

快速上手

1. L1 快速检查（手动执行）

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

2. L2 每小时检查（手动执行）

python scripts/l2_hourly_check.py

3. 配置 Crontab

cat templates/crontab_example.txt
# 复制并编辑 crontab
crontab -e

4. 心跳检查

python scripts/heartbeat.py

配置

编辑 config/default_config.yaml：

# 国际化设置
i18n:
  auto_detect: true  # 自动检测系统语言
  # locale: zh-CN    # 或手动指定

# 阈值设置
thresholds:
  disk_warning: 80      # 磁盘使用率警告阈值（%）
  disk_critical: 95     # 磁盘使用率严重阈值（%）
  memory_warning_mb: 500  # 内存使用量警告阈值（MB）
  log_size_mb: 100      # 日志文件大小警告阈值（MB）

# 心跳设置
heartbeat:
  enabled: true
  work_hours_start: 9
  work_hours_end: 18
  quiet_on_ok: true  # 全部正常时保持静默

输出示例

L2 每小时检查

🦞 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_OK

心跳检查（检测到问题）

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

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

脚本说明

CLI 参数选项

# 输出 JSON 格式
python scripts/l2_hourly_check.py --json

# 静默模式（仅返回退出码）
python scripts/l2_hourly_check.py --quiet

# 强制输出（心跳检查）
python scripts/heartbeat.py --force

退出码说明

• 0：所有检查通过
• 1：一个或多个检查失败

国际化支持

当前支持的语言：

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

默认从系统 locale 自动检测。如需覆盖，请设置环境变量：

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

运行要求

• Python 3.8+
• Linux 或 macOS
• 无外部依赖（可选：使用 rich 实现彩色输出，pyyaml 用于配置解析）

参与贡献

欢迎提交贡献！请先阅读 CONTRIBUTING.md。

更新日志

v1.0.0（2026-03-23）

• 初始发布
• 实现 L1/L2/L3 三级检查机制
• 引入心跳机制
• 支持 i18n（en/zh-CN）