← Back to Skills Marketplace
olveww-dot

Claw Health

by ECsss · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
246
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install claw-health
Description
Monitors OpenClaw health in real-time, offers one-click repair, security scanning, and a web dashboard for system and skill status.
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
What to check before installing: - Verify the source: the registry lists no homepage and the SKILL.md points to a third‑party GitHub repo; confirm you trust the author/URL (contact email is present but unverified). - Audit the code yourself (install.sh, package.json, all .py files). Pay attention to any network calls (api.clawdoctor.io), install/downloads performed by install.sh, and any code that writes/overwrites files or runs shell commands. - Expect the skill to access and modify local OpenClaw files and system processes (reads logs, edits ~/.openclaw/openclaw.json, deletes large logs, kills/restarts processes). Do not run on a production host without review and backups. - Run in a sandbox or non-production environment first. Monitor outgoing network connections while exercising the tool (to detect unexpected exfiltration). - If you want to use the dashboard, host it locally and inspect dashboard and server scripts for third‑party calls. Remove or disable cloud reporting code (and any hardcoded endpoints) unless you explicitly opt in and supply credentials. - Because the scanner flagged hidden control characters in SKILL.md, fetch the raw files and inspect them for invisible characters or obfuscated instructions. If you lack the ability to audit the code, treat this skill as potentially risky and avoid enabling autonomous invocation or installing it on sensitive systems.
Capability Analysis
Type: OpenClaw Skill Name: claw-health Version: 1.0.0 ClawDoctor is a health monitoring and repair utility for the OpenClaw ecosystem. The bundle includes scripts (clawdoctor.py, agent.py) that use psutil for system resource tracking and subprocess calls to manage the OpenClaw gateway process. While the installation script (install.sh) modifies shell profiles (.bashrc/.zshrc) to update the PATH and the agent includes a placeholder for cloud-based heartbeat reporting (api.clawdoctor.io), these actions are transparently documented and consistent with the tool's stated purpose of monitoring and 'one-click' repair. No evidence of credential theft, unauthorized exfiltration, or malicious prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (health monitor + one‑click fix + dashboard) align with the included code: the package contains monitoring, repair, and dashboard files that inspect logs, processes, and config and restart services. However, the registry metadata claims 'instruction-only' and lists no required binaries/env vars while the code clearly calls system tools (curl, pkill, tail, grep, openclaw, launchctl) and touches OpenClaw config/log paths — those runtime requirements are not declared.
Instruction Scope
SKILL.md gives simple install and CLI usage but does not enumerate the full scope of runtime actions. The actual code reads local logs (~/.openclaw, /tmp/openclaw), inspects processes, edits/backs up openclaw.json, deletes large logs, terminates and restarts processes/services, and may contact an external API. Those file reads and destructive actions (deleting logs, terminating processes, overwriting config) are broad and impactful; SKILL.md does not explicitly warn or request explicit consent for those.
Install Mechanism
Registry lists no install spec but the bundle includes install.sh, package.json, and multiple Python scripts; SKILL.md suggests git cloning from a GitHub repo. The code bundle is present in the skill payload (so installing the skill will write/contain executable scripts). No remote download URL shorteners were seen, but the mismatch between 'instruction-only' metadata and included code is a packaging/information inconsistency to verify.
Credentials
The skill declares no required environment variables or primary credential, yet code contains a cloud endpoint (CONFIG.api_endpoint = https://api.clawdoctor.io/v1/heartbeat) and api_key/user_id placeholders and imports requests. While sending to cloud is currently commented out in one file, the presence of a hardcoded endpoint and the ability to enable reporting means network exfiltration could be enabled later without declaring credentials. Also the code expects system utilities (openclaw, pkill, curl, launchctl) and access to home-dir config/log paths — sensitive accesses not reflected in declared requirements.
Persistence & Privilege
The skill can modify system state: terminate processes, delete large log files, backup and overwrite openclaw.json, restart gateway services. The skill is allowed to be invoked autonomously (platform default), which increases blast radius if enabled; although 'always' is false, autonomous invocation combined with these privileged actions is riskier than a read‑only monitor and should be considered before granting runtime privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install claw-health
  3. After installation, invoke the skill by name or use /claw-health
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of ClawDoctor skill: - Real-time health monitoring for OpenClaw components and system resources - One-click repair for common OpenClaw issues - Integrated security risk scanning - Web dashboard with live data visualization (supports English & Chinese) - Offers both CLI and web interface for monitoring and repair
Metadata
Slug claw-health
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Claw Health?

Monitors OpenClaw health in real-time, offers one-click repair, security scanning, and a web dashboard for system and skill status. It is an AI Agent Skill for Claude Code / OpenClaw, with 246 downloads so far.

How do I install Claw Health?

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

Is Claw Health free?

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

Which platforms does Claw Health support?

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

Who created Claw Health?

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

💬 Comments