A comprehensive system health diagnostic and autonomous repair suite designed to maintain OpenClaw installations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-doctor
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-doctor 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 Doctor?
OpenClaw Doctor is a robust health diagnostic and auto-repair utility specifically engineered to keep your AI infrastructure running at peak efficiency. Unlike standard checkups, this tool performs deep architectural inspections of gateways, service resilience, and resource allocation to ensure your Openclaw Skills remain responsive and stable.
By identifying and resolving bottlenecks before they cause downtime, it provides a layer of self-healing intelligence for your workspace. Whether you are dealing with memory leaks, disconnected channels, or cron failures, OpenClaw Doctor acts as an automated system administrator for your agent environment.
OpenClaw Doctor Use Cases
- Resolving system slowness or unresponsive gateway processes.
- Troubleshooting failed cron jobs or automation routines.
- Reconnecting Telegram or WhatsApp channels that have dropped offline.
- Performing routine health audits as part of a heartbeat monitoring cycle.
- Validating system integrity after power outages or version upgrades.
How OpenClaw Doctor Works
- The agent triggers the diagnostic script which scans the gateway status and port availability.
- It evaluates system resources, including CPU load, memory pressure, and disk space health.
- The tool verifies service resilience by checking auto-boot configurations and Node.js path validity.
- It audits security protocols, ensuring config file permissions and gateway tokens meet safety standards.
- If the --fix flag is enabled, the skill autonomously executes repair commands to resolve identified issues.
OpenClaw Doctor Setup
To install and run the diagnostic suite within your environment, use the following commands:
# Run a full diagnostic in read-only mode
bash scripts/diagnose.sh
# Execute diagnostics with autonomous repair enabled
bash scripts/diagnose.sh --fix
# Run a high-speed essential health check
bash scripts/diagnose.sh --quick
OpenClaw Doctor Data Schema & Taxonomy
The skill organizes system data and diagnostic metadata into the following structure:
| Category | Monitored Data Points |
|---|---|
| Gateway | PID status, port latency, LaunchAgent/systemd state, auth token strength. |
| Storage | Disk usage percentages, log file sizes, and memory file counts. |
| Cron | Job status, failure logs, and stale job detection (2x interval check). |
| Security | Workspace permissions (600), exposed ports, and credential encryption. |
| Logs | Rotation of logs older than 30 days and vector index health checks. |
OpenClaw Doctor Advanced Features
- Auto-Fix Engine: Automatically restarts crashed services and rotates oversized log files.
- Heartbeat Integration: Supports periodic execution via HEARTBEAT.md for continuous monitoring.
- Multi-Platform Support: Full compatibility with macOS and Linux (systemd), with basic support for Windows WSL.
- Predictive Alerts: Triggers warnings at 80% disk capacity and critical alerts at 90%.
SKILL.md
Loading
Related Openclaw Skills
Dashform Form Creation
A sophisticated AI-driven tool for building and managing intelligent surveys, quizzes, and conversational forms through the Model Context Protocol.
Agent Daily Report
An automated reporting skill that empowers AI agents to review their session logs and output professional, quantified daily work summaries.
XferOps Sentry
An MCP-powered skill for querying Sentry issues, events, and projects to streamline incident investigation and triage.
OpenClaw Setup Wizard
An interactive diagnostic and configuration suite designed to streamline the setup, optimization, and security hardening of OpenClaw installations.
Xueqiu Summary & Investment Advisor
An intelligent investment assistant that scrapes top financial influencers and real-time stock data from Xueqiu to provide actionable market summaries.
FormPass Forms Integration
A powerful integration tool that makes standard web forms discoverable and submittable by verified AI agents.
Featured*
