system-healthcheck 三层系统健康监控,适用于 OpenClaw
英文 | 简体中文
功能
L1 快速检查(<200ms):定义文件存在性检查
L2 小时检查(<5s):系统资源、服务、日志
L3 每日审计(<60s):全面系统审计
心跳机制:健康时静默,问题时报警
i18n 支持:自动检测语言(en/zh-CN)
零外部依赖:开箱即用
安装
clawhub install system-healthcheck
或通过 OpenClaw 安装:
openclaw skills install system-healthcheck
快速开始
cd ~/.openclaw/skills/system-healthcheck
python scripts/l1_fast_check.py
python scripts/l2_hourly_check.py
cat templates/crontab_example.txt
# 复制并编辑 crontab
crontab -e
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
# 静默时所有 OK
输出示例
L2 小时检查
System Health Check · 2026-03-23 09:00:00
Disk Usage:45%(阈值:80%)
Memory Usage:1.2GB / 8GB
Cron Service:Running
OpenClaw Gateway:Healthy
Log Files:12MB
━━━━━━━━━━━━━━━━━━━━━━━━
All checks passed
Duration:1.2s
心跳(所有 OK)
HEARTBEAT_OK
心跳(问题检测)
Heartbeat Check · 2026-03-23 14:30:00
Disk Usage:85%(超过 80%)
Memory Usage:2.1GB / 8GB
...
脚本
脚本目的
频率
l1_fast_check.py
定义文件检查
对话前
l2_hourly_check.py
系统健康检查
小时(cron)
l3_daily_audit.py
全面审计
每日 08:00(cron)
heartbeat.py
工作时间心跳
每 30 分钟(cron)
CLI 选项
# JSON 输出
python scripts/l2_hourly_check.py --json
# 静默模式(仅退出代码)
python scripts/l2_hourly_check.py --quiet
# 强制输出(心跳)
python scripts/heartbeat.py --force
退出代码
0:所有检查通过
1:一个或多个检查失败
国际化
支持语言:
en - 英文
zh-CN - 简体中文
从系统区域设置自动检测。
使用以下命令覆盖:
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)