📖 Layer 1: Immediate Value (30-Second Overview)
What You Get
The
System Maintenance Skill provides a complete, unified maintenance solution for OpenClaw systems. It includes real-time monitoring, automated cleanup, log management, and health reporting - all in a modular, easy-to-maintain architecture.
Key Benefits:
- - ✅ Automated monitoring every 5 minutes
- ✅ Auto-recovery of failed services
- ✅ 50% reduction in cron tasks
- ✅ Full backup and one-click rollback
- ✅ Weekly optimization reports
Core Value: Replaces fragmented maintenance scripts with a professional, unified system maintenance solution.
🚀 Layer 2: Quick Start (5-Minute Setup)
Installation
Method 1: ClawHub Install (Recommended)
CODEBLOCK0
Method 2: GitHub Clone
CODEBLOCK1
One-Click Setup
CODEBLOCK2
Verification
CODEBLOCK3
🏗️ Layer 3: Architecture & Components
Maintenance Schedule
| Frequency | Task | Description | Script |
|---|
| Every 5 min | Real-time Monitoring | Gateway monitoring & auto-recovery | INLINECODE0 |
| Daily 2:00 AM |
Log Management | Log cleanup, rotation, compression |
log-management.sh |
| Daily 3:30 AM | Daily Maintenance | Comprehensive cleanup & health checks |
daily-maintenance.sh |
| Sunday 3:00 AM | Weekly Optimization | Deep system analysis & reporting |
weekly-optimization.sh |
Core Functions
🏗️ Unified Architecture
- - Modulardesign with 5 core scripts
- Configuration-driven management
- Safe migration from old systems
- Professional directory layout
⏱️ Smart Monitoring & Recovery
- - Real-time gateway monitoring
- Automatic service recovery
- Health scoring system (0-100)
- Resource tracking (CPU, memory, disk)
- macOS compatibility
📊 Professional Reporting
- - Weekly optimization reports (Markdown)
- Execution summaries
- Optimization suggestions
- Performance metrics tracking
🛡️ Safety & Reliability
- - Complete backup system
- One-click rollback
- Error recovery with graceful handling
- Security checks for sensitive info
- Proper permission management
🔄 Maintenance Automation
- - Log rotation & cleanup
- Temporary file cleanup
- Daily health checks
- Automatic .learnings/ updates
📚 Layer 4: Resources & Reference
File Structure
CODEBLOCK4
Command Reference
Real-time Monitor
CODEBLOCK5
Log Management
CODEBLOCK6
Daily Maintenance
CODEBLOCK7
Weekly Optimization
CODEBLOCK8
Version History
| Version | Date | Changes |
|---|
| 1.3.2 | 2026-03-16 | Reorganized SKILL.md with progressive disclosure; cleaned up backup files |
| 1.3.1 |
2026-03-16 | Added FS Governance; improved error handling |
| 1.3.0 | 2026-03-12 | Archival version, initial ClawHub release |
🔧 Layer 5: Advanced Configuration
Customization Options
- - Configuration file: INLINECODE4
- Monitoring intervals: Adjust in INLINECODE5
- Log policies: Modify in INLINECODE6
- Health thresholds: Configure in health check scripts
Integration Points
- - System Status API: Emergency endpoints
- Logging Forwarding: External log aggregation
- Metrics Export: Prometheus/Grafana compatible
- Webhook Notifications: Slack, Discord, email
Security Features
- - Encrypted Backups: Optional GPG encryption
- Access Controls: File permission management
- Audit Logging: All maintenance actions logged
- Secrets Management: Integration with vault systems
🛠️ Usage Examples
Quick Health Check
CODEBLOCK9
Emergency Recovery
CODEBLOCK10
Performance Tuning
CODEBLOCK11
🤝 Contributing
Please read CONTRIBUTING.md before submitting pull requests.
📜 License
MIT License - see LICENSE file for details.
Built with ❤️ for the OpenClaw community
📖 第一层:即时价值(30秒概览)
你将获得
系统维护技能为OpenClaw系统提供了一套完整、统一的维护解决方案。它包含实时监控、自动清理、日志管理和健康报告——全部采用模块化、易于维护的架构。
主要优势:
- - ✅ 每5分钟自动监控
- ✅ 故障服务自动恢复
- ✅ 减少50%的定时任务
- ✅ 完整备份与一键回滚
- ✅ 每周优化报告
核心价值: 用专业、统一的系统维护方案替代零散的维护脚本。
🚀 第二层:快速入门(5分钟配置)
安装
方法一:ClawHub安装(推荐)
bash
bunx clawhub@latest install system-maintenance
方法二:GitHub克隆
bash
git clone https://github.com/jazzqi/openclaw-system-maintenance.git \
~/.openclaw/skills/system-maintenance
cd ~/.openclaw/skills/system-maintenance
chmod +x scripts/*.sh
一键安装
bash
bash scripts/install-maintenance-system.sh
验证
bash
检查定时任务
crontab -l | grep -i openclaw
测试监控
bash scripts/real-time-monitor.sh --test
快速健康检查
bash scripts/daily-maintenance.sh --quick-check
🏗️ 第三层:架构与组件
维护计划
| 频率 | 任务 | 描述 | 脚本 |
|---|
| 每5分钟 | 实时监控 | 网关监控与自动恢复 | real-time-monitor.sh |
| 每天凌晨2:00 |
日志管理 | 日志清理、轮转、压缩 | log-management.sh |
| 每天凌晨3:30 | 日常维护 | 全面清理与健康检查 | daily-maintenance.sh |
| 周日凌晨3:00 | 每周优化 | 深度系统分析与报告 | weekly-optimization.sh |
核心功能
🏗️ 统一架构
- - 模块化设计,包含5个核心脚本
- 配置驱动管理
- 从旧系统安全迁移
- 专业目录布局
⏱️ 智能监控与恢复
- - 实时网关监控
- 自动服务恢复
- 健康评分系统(0-100)
- 资源追踪(CPU、内存、磁盘)
- macOS兼容性
📊 专业报告
- - 每周优化报告(Markdown格式)
- 执行摘要
- 优化建议
- 性能指标追踪
🛡️ 安全与可靠性
- - 完整备份系统
- 一键回滚
- 错误恢复与优雅处理
- 敏感信息安全检查
- 适当的权限管理
🔄 维护自动化
- - 日志轮转与清理
- 临时文件清理
- 每日健康检查
- 自动更新.learnings/
📚 第四层:资源与参考
文件结构
system-maintenance/
├── 📄 entry.js # 技能入口点
├── 📄 package.json # NPM配置
├── 📄 SKILL.md # 本文件
├── 🛠️ scripts/ # 核心脚本
│ ├── weekly-optimization.sh # 每周深度优化
│ ├── real-time-monitor.sh # 实时监控(5分钟)
│ ├── log-management.sh # 日志清理与轮转
│ ├── daily-maintenance.sh # 日常维护(凌晨3:30)
│ ├── install-maintenance-system.sh # 安装工具
│ └── check-before-commit.sh # 提交前质量检查
├── 📚 examples/ # 示例与模板
│ ├── setup-guide.md # 快速配置指南
│ ├── migration-guide.md # 安全迁移指南
│ ├── final-status-template.md # 状态报告模板
│ └── optimization-suggestions.md # 优化建议
├── 📝 docs/ # 附加文档
│ ├── FILESYSTEMGOVERNANCE.md # 文件系统治理标准
│ └── cross-platform-architecture.md
└── 📁 assets/ # 静态资源
└── README.md
命令参考
实时监控
bash
测试模式(不执行实际操作)
bash scripts/real-time-monitor.sh --test
强制执行
bash scripts/real-time-monitor.sh --force
查看状态
bash scripts/real-time-monitor.sh --status
日志管理
bash
预演运行(预览更改)
bash scripts/log-management.sh --dry-run
手动轮转
bash scripts/log-management.sh --rotate
仅清理
bash scripts/log-management.sh --cleanup
日常维护
bash
仅快速健康检查
bash scripts/daily-maintenance.sh --quick-check
完整维护周期
bash scripts/daily-maintenance.sh --full
跳过备份(紧急模式)
bash scripts/daily-maintenance.sh --no-backup
每周优化
bash
仅生成报告(不优化)
bash scripts/weekly-optimization.sh --report-only
仅分析(不做更改)
bash scripts/weekly-optimization.sh --analyze-only
完整优化周期
bash scripts/weekly-optimization.sh --optimize
版本历史
| 版本 | 日期 | 变更内容 |
|---|
| 1.3.2 | 2026-03-16 | 重新组织SKILL.md,采用渐进式披露;清理备份文件 |
| 1.3.1 |
2026-03-16 | 添加文件系统治理;改进错误处理 |
| 1.3.0 | 2026-03-12 | 归档版本,首次ClawHub发布 |
🔧 第五层:高级配置
自定义选项
- - 配置文件:scripts/config.json
- 监控间隔:在real-time-monitor.sh中调整
- 日志策略:在log-management.sh中修改
- 健康阈值:在健康检查脚本中配置
集成点
- - 系统状态API:紧急端点
- 日志转发:外部日志聚合
- 指标导出:兼容Prometheus/Grafana
- Webhook通知:Slack、Discord、邮件
安全特性
- - 加密备份:可选GPG加密
- 访问控制:文件权限管理
- 审计日志:所有维护操作均记录
- 密钥管理:与保险库系统集成
🛠️ 使用示例
快速健康检查
bash
按顺序运行所有健康检查
bash scripts/daily-maintenance.sh --quick-check
bash scripts/log-management.sh --status
bash scripts/real-time-monitor.sh --status
紧急恢复
bash
从最新备份强制恢复
bash scripts/install-maintenance-system.sh --restore-latest
手动重启服务
pkill -f openclaw-gateway && openclaw gateway start
性能调优
bash
调整监控频率(编辑配置)
默认:5分钟,可设置为1-60分钟
示例:关键系统设置为2分钟
🤝 贡献指南
请在提交拉取请求前阅读CONTRIBUTING.md。
📜 许可证
MIT许可证 - 详情请参阅LICENSE文件。
为OpenClaw社区倾心打造