An autonomous 4-tier recovery system that monitors gateway health and uses AI to diagnose and repair persistent failures.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-self-healing
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-self-healing 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 Self-Healing System?
The OpenClaw Self-Healing system is a professional-grade infrastructure tool designed to ensure the continuous availability of your AI gateway. Operating within the Openclaw Skills framework, it provides a resilient multi-layered defense against common operational failures, including process crashes, configuration errors, and resource leaks.
By combining traditional watchdog monitoring with state-of-the-art AI diagnosis, this skill minimizes downtime and reduces the need for manual intervention. It is a critical component for developers who require a 'set-and-forget' environment when deploying complex agents and services via Openclaw Skills.
OpenClaw Self-Healing System Use Cases
- Automatically restarting the OpenClaw Gateway after unexpected crashes or HTTP failures.
- Detecting and resolving expired OAuth tokens before they disrupt agent operations.
- Cleaning up orphaned zombie processes that cause port conflicts or PID mismatches.
- Performing AI-assisted troubleshooting of configuration schemas when automated restarts fail.
- Monitoring system health in production environments on both macOS and Linux.
How OpenClaw Self-Healing System Works
- The L1 config-watch script monitors for changes in configuration files to trigger instant validation and reloads.
- A L2 watchdog continuously polls the gateway health check URL to detect process hanging or connectivity issues.
- If a failure persists, the system executes an exponential backoff restart strategy and clears zombie processes.
- After a 30-minute failure window, L3 triggers the Claude Code AI doctor to perform a deep-dive diagnosis and apply logical repairs.
- Status updates and critical escalation alerts are pushed through L4 integration with Discord or Telegram.
OpenClaw Self-Healing System Setup
To deploy this recovery system within your Openclaw Skills environment, ensure tmux, jq, and the Claude Code CLI are installed.
Run the primary installation script:
bash <(curl -fsSL https://raw.githubusercontent.com/Ramsbaby/openclaw-self-healing/main/install.sh)
Alternatively, install via ClawHub:
npx clawhub@latest install openclaw-self-healing
Configure your environment variables (e.g., webhook URLs) in ~/.openclaw/.env.
OpenClaw Self-Healing System Data Schema & Taxonomy
The system organizes its operational data and recovery logs to ensure transparency and auditability:
| Component | Type | Description |
|---|---|---|
| Environment Config | .env | Stores gateway URLs, retry limits, and notification webhooks |
| Health Metrics | JSON | Tracks success rates, MTTR, and trending failure patterns |
| Reasoning Logs | Markdown | Detailed AI diagnostic steps taken during L3 recovery sessions |
| Process Monitoring | tmux | Real-time dashboard view of active recovery tiers |
OpenClaw Self-Healing System Advanced Features
- AI-powered Emergency Recovery v2 featuring multi-model support for Claude Code and Aider.
- Integrated metrics dashboard for real-time monitoring of Mean Time To Recovery (MTTR).
- Automated preflight checks that detect PID mismatches and perform SIGKILL on unresponsive processes.
- Cross-platform support with automated installers for macOS LaunchAgents and Linux systemd services.
- Extensible notification hooks for deep integration into enterprise communication workflows using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
MemoryBox
MemoryBox is a zero-dependency CLI tool designed to maintain a lean 3-tier hierarchical memory structure for Openclaw Skills.
Skill Optimizer
An automated diagnostic tool that analyzes AI conversation logs to evaluate performance and generate data-driven optimizations for agent skills.
WeChat Moments Copywriting Guide
A conversational AI guide designed to help users rediscover their authentic voice and write personalized WeChat Moments posts through guided reflection.
WeChat Moments Assistant (Pangyu)
A personalized AI copywriting assistant that learns your unique voice to create authentic WeChat Moments posts.
Self-Evolving Agent
A meta-analytical automation tool that observes AI agent performance and suggests optimized instruction updates based on semantic log patterns and real-time monitoring.
Playwright MCP
A high-performance browser automation skill that enables AI agents to interact with websites, fill forms, and extract data via the Playwright framework.
METADATA
Featured*
