OpenClaw Unified Maintenance System Skill

OpenClaw System Maintenance Skill

Complete maintenance system for OpenClaw with unified architecture
Real‑time monitoring, automated cleanup, log management, and health reporting

📋 Overview

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:

• 🚀 50% fewer cron tasks - From 8 to 4 optimized tasks
• 🛡️ Automatic recovery - Self-healing system with health scoring
• 📊 Professional reporting - Weekly optimization reports
• 🔄 Safe migration - Complete backup and rollback system
• 🍎 macOS compatible - Tested and optimized for macOS
• 🌐 Cross-platform design - Architecture预留 for Linux and Windows
• 🏗️ Modular architecture - Easy to extend for other platforms

🚀 Features

🏗️ Unified Architecture

• Modular design - 5 core scripts with clear responsibilities
• Configuration-driven - Centralized configuration management
• Easy migration - Safe migration from old to new systems

⏱️ Smart Monitoring

• Real-time Gateway monitoring - Every 5 minutes
• Automatic recovery - Restart failed services automatically
• Health scoring - 0-100 automatic health score system

📊 Professional Reporting

• Weekly optimization reports - Markdown format with detailed analysis
• Execution summaries - Easy-to-read summaries
• Optimization suggestions - Actionable recommendations

🛡️ Safety Features

• Complete backups - Full system backup before any changes
• One-click rollback - Revert to previous state anytime
• Error recovery - Graceful failure handling

📁 File Structure

system-maintenance/
├── 📄 README.md                    # This file
├── 📄 SKILL.md                     # Skill documentation (English)
├── 📄 SKILL.md.zh-CN.bak           # Chinese documentation backup
├── 📄 package.json                 # NPM configuration (v1.3.0)
├── 📄 entry.js                     # Skill entry point
├── 📄 .gitignore                   # Git ignore rules
├── 📄 pre-commit-checklist.md      # Pre-commit checklist guidelines
├── 🛠️  scripts/                    # Core maintenance scripts
│   ├── weekly-optimization.sh      # Weekly deep optimization
│   ├── real-time-monitor.sh        # Real-time monitoring (every 5 min)
│   ├── log-management.sh           # Log cleanup and rotation
│   ├── daily-maintenance.sh        # Daily maintenance (3:30 AM)
│   ├── install-maintenance-system.sh # Installation tool
│   └── check-before-commit.sh      # Pre-commit quality check
├── 📚  examples/                   # Examples and templates
│   ├── setup-guide.md              # Quick setup guide
│   ├── migration-guide.md          # Safe migration guide
│   ├── final-status-template.md    # Status report template
│   └── optimization-suggestions.md # Optimization suggestions
├── 📝  docs/                       # Additional documentation
│   ├── architecture.md             # System architecture
│   ├── cross-platform-architecture.md # Cross-platform design
│   └── PUBLISH_GUIDE.md            # Publication guide
└── 📁 backup-v1.0.0/              # Version 1.0.0 backup

🚀 Quick Start

Installation

# Method 1: Install from ClawHub (recommended)
clawhub install system-maintenance

# Method 2: Clone from GitHub
git clone https://github.com/jazzqi/openclaw-system-maintenance.git ~/.openclaw/skills/system-maintenance
cd ~/.openclaw/skills/system-maintenance

# Make scripts executable
chmod +x scripts/*.sh

One-Click Installation & Setup

# Run the installation script (does everything automatically)
bash ~/.openclaw/skills/system-maintenance/scripts/install-maintenance-system.sh

# Verify installation
crontab -l | grep -i openclaw
# Should show 4 maintenance tasks

Quick Test

# Test real-time monitoring
bash ~/.openclaw/skills/system-maintenance/scripts/real-time-monitor.sh --test

# Check system health
bash ~/.openclaw/skills/system-maintenance/scripts/daily-maintenance.sh --quick-check

Manual Setup

# Copy scripts to your maintenance directory
cp -r ~/.openclaw/skills/system-maintenance/scripts/ ~/.openclaw/maintenance/

# Make scripts executable
chmod +x ~/.openclaw/maintenance/scripts/*.sh

# Add to crontab
(crontab -l 2>/dev/null; echo "*/5 * * * * ~/.openclaw/maintenance/scripts/real-time-monitor.sh") | crontab -
(crontab -l 2>/dev/null; echo "0 2 * * * ~/.openclaw/maintenance/scripts/log-management.sh") | crontab -
(crontab -l 2>/dev/null; echo "30 3 * * * ~/.openclaw/maintenance/scripts/daily-maintenance.sh") | crontab -
(crontab -l 2>/dev/null; echo "0 3 * * 0 ~/.openclaw/maintenance/scripts/weekly-optimization.sh") | crontab -

⏰ Maintenance Schedule

🔧 Core Scripts

1. 📅 Weekly Optimization (weekly-optimization.sh)

• Frequency: Sundays at 3:00 AM
• Purpose: Deep system analysis and optimization
• Key Features:
  • ✅ Health scoring (0-100 automatic score)
  • ✅ Professional reports (Markdown format)
  • ✅ Resource analysis (disk, memory, CPU)
  • ✅ Error statistics (track and analyze issues)
  • ✅ Performance metrics (restart count, uptime)

2. ⏱️ Real-time Monitor (real-time-monitor.sh)

• Frequency: Every 5 minutes
• Purpose: Continuous system monitoring and recovery
• Key Features:
  • ✅ Gateway monitoring (process and port checks)
  • ✅ Automatic recovery (restart failed services)
  • ✅ Resource tracking (CPU, memory usage)
  • ✅ macOS compatible (fixed detection issues)
  • ✅ Detailed logging (complete execution records)

3. 📁 Log Management (log-management.sh)

• Frequency: Daily at 2:00 AM
• Purpose: Professional log lifecycle management
• Key Features:
  • ✅ Log rotation (prevent disk space issues)
  • ✅ Compression (save space, keep history)
  • ✅ Cleanup (remove logs older than 7 days)
  • ✅ Permission checks (ensure proper access)
  • ✅ Backup protection (never delete recent logs)

4. 🧹 Daily Maintenance (daily-maintenance.sh)

• Frequency: Daily at 3:30 AM
• Purpose: Comprehensive daily system upkeep
• Key Features:
  • ✅ Temporary file cleanup (keep system tidy)
  • ✅ Health validation (verify core functions)
  • ✅ Learning updates (update .learnings/ records)
  • ✅ Backup checks (verify backup integrity)
  • ✅ Quick optimization (small daily improvements)

5. 🛠️ Installation Tool (install-maintenance-system.sh)

• Frequency: One-time setup
• Purpose: Easy and complete system installation
• Key Features:
  • ✅ Automatic setup (crontab configuration)
  • ✅ Permission configuration (make scripts executable)
  • ✅ Verification (test all components)
  • ✅ Migration support (from old maintenance systems)
  • ✅ Rollback capability (safe installation)