← Back to Skills Marketplace
olveww-dot

ClawDoctor

by ECsss · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
253
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install clawdoctor-openclaw
Description
Monitors OpenClaw health with real-time status, one-click fixes, security scans, and a web dashboard supporting Chinese and English.
README (SKILL.md)

ClawDoctor Skill

OpenClaw Health Monitor & Fixer

Description

ClawDoctor is a health monitoring and repair tool for OpenClaw. It provides real-time monitoring, one-click repair, security scanning, and a beautiful web dashboard.

Features

  • 🔍 Real-time monitoring (Gateway, skills, system resources)
  • 🔧 One-click repair for common issues
  • 🛡️ Security risk scanning
  • 📊 Web dashboard with data visualization
  • 🌐 Chinese & English support

Installation

npx clawhub install clawdoctor

Or manually:

git clone https://github.com/olveww-dot/clawdoctor.git ~/.openclaw/skills/clawdoctor

Usage

CLI

# Check status
clawdoctor --status

# One-click fix
clawdoctor --fix

# Security scan
clawdoctor --scan

Web Dashboard

# Start server
clawdoctor-server

# Open http://127.0.0.1:8080/dashboard.html

Requirements

  • Python 3.10+
  • psutil
  • OpenClaw installed

Author

梁溪区佳妮电子商务工作室 EC & 小呆呆

📧 [email protected]

License

MIT

Usage Guidance
Plain-language checklist before installing or running this skill: - Understand what it will do: the package contains runnable agents and a web server that will read OpenClaw logs/configs (~/.openclaw, /tmp/openclaw), stop/kill processes, restart the gateway, edit config files, and delete large logs. Those are powerful, potentially disruptive actions. - Inspect install.sh and server.py locally (do not run them) to see exactly what will be executed. If you are not comfortable reading shell/Python scripts, ask a technical colleague to review them. - Don’t run it as root. Test inside an isolated environment (VM, container, or disposable machine) first so any destructive actions are contained. - Backup OpenClaw config and logs (e.g., copy ~/.openclaw) before allowing fixes to run, so you can restore if something changes unexpectedly. - Check network behavior: the code includes a cloud API endpoint (https://api.clawdoctor.io) and a placeholder for api_key. Unless you trust the upstream service and author, avoid setting API keys or enabling cloud reporting. Monitor outbound network connections while running the tool. - Verify upstream source: SKILL.md references a GitHub repo (github.com/olveww-dot/clawdoctor). Confirm the repo, its commit history, and that the package you install matches that repository. Contact the author for clarification about the cloud endpoint and the unicode-control-chars finding. - If you only want monitoring (no changes), run the read-only scripts (e.g., the _simple agent) in read-only mode and avoid invoking any 'fix' or 'start' actions from the dashboard. If you cannot perform these checks or do not trust the origin, treat the skill as untrusted and avoid installing it on production systems.
Capability Analysis
Type: OpenClaw Skill Name: clawdoctor-openclaw Version: 1.0.1 ClawDoctor is an OpenClaw maintenance utility that provides system monitoring, service auto-repair, and a web-based dashboard. It is classified as suspicious because it performs several high-risk operations: it modifies shell configuration files (~/.bashrc and ~/.zshrc) to establish persistence for its CLI, runs a local HTTP server (server_simple.py), and requires broad permissions to terminate processes and read system logs. Additionally, agent.py contains inactive telemetry logic designed to exfiltrate system health reports to a remote endpoint (api.clawdoctor.io), and clawdoctor.py includes a 'SecurityScanner' that aggressively flags other installed skills for using common programming patterns.
Capability Assessment
Purpose & Capability
The name/description (OpenClaw health monitor & fixer) matches the included code: multiple agent and server scripts, dashboard, and fixer logic. However the SKILL metadata declared no required binaries or env vars while the code clearly calls external tools (curl, tail, grep, pkill, launchctl, openclaw CLI) and reads/writes OpenClaw config/log directories. The omission of required binaries/config declarations is an inconsistency and reduces transparency.
Instruction Scope
SKILL.md gives simple install/run instructions and doesn't mention the full runtime actions. The package code goes beyond passive monitoring: it reads many local files (~/.openclaw, /tmp/openclaw, logs), edits configuration (overwrites ~/.openclaw/openclaw.json), kills/terminates processes, restarts services, deletes large logs, and includes a web server/dashboard that triggers actions. Those behaviors are within a 'fixer' scope but are powerful and not fully documented in SKILL.md, granting broad discretion over local system state.
Install Mechanism
The registry entry contains no formal install spec but the package includes an install.sh and multiple executable Python scripts. SKILL.md suggests git cloning from a GitHub repo (a reasonable source) or npx clawhub; install.sh content wasn't shown but is present and could execute arbitrary commands. The lack of an explicit, auditable install step in the skill metadata plus included scripts is a risk because users may run the script without fully reviewing it.
Credentials
The skill declares no required environment variables or credentials, yet the code contains a configurable cloud API endpoint and api_key placeholder (agent.py), imports requests, and has a send_to_cloud function (commented out) — meaning the code is structured to send reports remotely if configured. The package also accesses many local config/log paths and system process state despite no declared need for special credentials. That mismatch (no declared secrets but capacity to read/modify local files and to report externally) is disproportionate and warrants caution.
Persistence & Privilege
always:false and no explicit persistent privilege escalation flags are set. Still, the included agents are designed to run continuously and perform system-level actions (process termination, restart, config editing). While not requesting platform-level 'always' privilege, the code can change system state when executed and could be invoked autonomously by an agent runtime — a risk amplified if run with high privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawdoctor-openclaw
  3. After installation, invoke the skill by name or use /clawdoctor-openclaw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Update skill info
v1.0.0
Initial release of ClawDoctor – a health monitoring and repair tool for OpenClaw. - Real-time monitoring of gateway, skills, and system resources - One-click repair for common issues - Security risk scanning functionality - Web dashboard with data visualization - Supports both Chinese and English - Simple CLI and easy installation instructions
Metadata
Slug clawdoctor-openclaw
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is ClawDoctor?

Monitors OpenClaw health with real-time status, one-click fixes, security scans, and a web dashboard supporting Chinese and English. It is an AI Agent Skill for Claude Code / OpenClaw, with 253 downloads so far.

How do I install ClawDoctor?

Run "/install clawdoctor-openclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ClawDoctor free?

Yes, ClawDoctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ClawDoctor support?

ClawDoctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ClawDoctor?

It is built and maintained by ECsss (@olveww-dot); the current version is v1.0.1.

💬 Comments