A comprehensive suite of automation scripts designed to monitor, maintain, and optimize the stability of OpenClaw environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-maintenance
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-maintenance using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenClaw Maintenance Toolkit?
The OpenClaw Maintenance Toolkit is a professional-grade set of utilities built to ensure the 24/7 operational reliability of OpenClaw. It addresses common infrastructure challenges such as service crashes, network proxy instability, and storage bloat from logs. By integrating these scripts into your workflow, you significantly improve your Openclaw Skills by automating the tedious aspects of agent server management.
This toolkit provides cross-platform support, making it equally effective on macOS (via LaunchAgents), Linux (via systemd or cron), and NAS environments. It bridges the gap between raw AI agent deployment and production-ready stability, offering developer-friendly hooks for notifications and automated recovery.
OpenClaw Maintenance Toolkit Use Cases
- Ensuring the OpenClaw Gateway remains active with automated watchdog monitoring.
- Automatically resolving message queue congestion by switching network proxy nodes when latency or accumulation occurs.
- Maintaining system health on low-storage devices like NAS or VPS through automated log rotation.
- Implementing graceful restarts to prevent service interruptions during configuration changes.
How OpenClaw Maintenance Toolkit Works
- The watchdog script executes a heartbeat check on the Gateway service to confirm its responsiveness.
- Simultaneously, the proxy monitor analyzes the message queue; if thresholds are exceeded, it interacts with the Clash/Mihomo API to rotate nodes.
- Based on the predefined schedule (cron or launchd), the cleanup utility identifies and removes expired log files to prevent disk saturation.
- If any recovery action is taken, the system triggers a notification to the specified target using the Openclaw Skills framework for real-time alerting.
OpenClaw Maintenance Toolkit Setup
To get started with the maintenance toolkit, follow these steps to integrate it into your environment:
# 1. Initialize your environment configuration
cp .env.example .env
# 2. Configure your notification ID and optional API secrets
vim .env
# 3. Execute the automated installation script
bash install.sh
# 4. Verify the setup with the diagnostic tool
bash check.sh
For macOS users, load the background agent using:
launchctl load ~/Library/LaunchAgents/ai.openclaw.watchdog.plist
OpenClaw Maintenance Toolkit Data Schema & Taxonomy
The toolkit utilizes a central .env file for configuration and produces structured logs. Below are the key configuration parameters:
| Parameter | Description | Requirement |
|---|---|---|
OPENCLAW_NOTIFY_TARGET |
Telegram ID for receiving maintenance alerts | Required |
CLASH_API |
The local or remote endpoint for proxy management | Optional |
QUEUE_THRESHOLD |
Maximum number of queued messages before node switching | Default: 100 |
CLASH_SECRET |
Authentication token for your proxy controller | Optional |
OpenClaw Maintenance Toolkit Advanced Features
- Multi-platform daemon support including systemd for Linux and LaunchAgents for macOS.
- Intelligent proxy health monitoring that integrates directly with Clash and Mihomo APIs for seamless network failover.
- Customizable queue threshold logic to prevent AI agent bottlenecks during high-traffic periods.
- Safe restart protocols that ensure the Gateway is only rebooted when it is truly unresponsive, preventing false positives.
- Unified notification system to centralize status updates for all your Openclaw Skills across different devices.
SKILL.md
Loading
Related Openclaw Skills
lu-music-player
A powerful AI agent skill for managing Mopidy music services and local audio libraries on NAS environments.
Lu Auto Deploy
An automated Docker deployment skill designed to simplify container orchestration and service management through one-click templates.
Nova Net Worth
A comprehensive financial intelligence skill that allows AI agents to query net worth, portfolio holdings, transactions, and AI-driven financial insights.
Meeting Transcripts (Fireflies.ai)
Automatically capture, summarize, and organize meeting transcripts from Fireflies.ai into structured Markdown files.
fail2ban-reporter
An automated security tool that monitors fail2ban, reports malicious IPs to AbuseIPDB, and sends real-time notifications.
Proposal Copilot
A specialized AI assistant that generates professional freelance proposals, bid scores, and follow-up sequences from job descriptions.
Featured*
