Oc

Comprehensive diagnostic, error-fixing, and skill recommendation tool for OpenClaw

Security Scan

The skill's code, install steps, and runtime instructions are consistent with a local OpenClaw diagnostic/auto-fix tool — it requests only Python and common libs and runs local scripts that modify OpenClaw configs and services, which fits its stated purpose, but it performs privileged and potentially destructive operations so review before use.

Purpose & Capability

Name/description match the actual files and commands: Python scripts, data files, docs, and a skill-recommender/clawhub client. Required binaries (python3) and declared pip deps (click, rich, requests, beautifulsoup4) are proportionate to the stated diagnostic/recommendation purpose.

Instruction Scope

SKILL.md instructs the agent to run local Python scripts (error-fixer, enhanced-doctor, skill-recommender, setup-wizard, self-updater). Those scripts — per included data/recipes — will read OpenClaw config/.env, logs, and may run system commands (kill processes, start Docker, modify openclaw.json, install packages, download binaries). That scope is consistent with an auto-fix tool but includes risky actions (force-kill, systemctl, global npm installs, downloading/extracting binaries) which the agent could perform when invoked.

Install Mechanism

Install uses a simple pip install of well-known Python packages (click, rich, requests, beautifulsoup4). No arbitrary URL downloads are present in the declared install step. The package install list is proportionate to the codebase.

Credentials

The skill declares no required environment variables, but its references and fix recipes frequently mention sensitive variables (OPENAI_API_KEY, ANTHROPIC_API_KEY, GATEWAY_TOKEN, channel tokens, etc.) and will read or prompt for them during diagnosis/auto-fix. Not declaring them up-front is not inherently incoherent, but users should expect the tool to access configs and environment variables and to request tokens for provider actions.

Persistence & Privilege

always:false and disable-model-invocation:false (default) — the skill is not force-installed but can be invoked autonomously. Because it can run destructive system commands (kill processes, start daemons, install software, download binaries into /opt), autonomous invocation increases blast radius; this is expected for an auto-fix utility but worth user review before enabling autonomous runs.

Assessment

This package appears to be what it claims: a local OpenClaw diagnostic and auto-fix suite. Before installing/using it: 1) Review the scripts (especially self-updater.py and any code that performs network requests) for where they fetch updates or send data. 2) Run it in a non-production sandbox or with dry-run options first (many commands have --dry-run or --check modes). 3) Back up openclaw.json and any configs before applying auto-fixes (the tool documents backups but verify behavior). 4) Be cautious granting sudo/root or allowing destructive fixes (kill -9, systemctl start, global npm installs, downloads to /opt). 5) If you need to trust network endpoints, confirm the project's GitHub/homepage and consider auditing clawhub_client/doc_fetcher calls to ensure no secret exfiltration. If you want higher assurance, request a code audit or run the scripts in a readonly / isolated environment first.

OpenClaw Doctor Pro

Ultimate diagnostic, error-fixing, and skill recommendation tool for OpenClaw.

When to Use

Activate when user wants to:

• Diagnose OpenClaw errors or issues
• Auto-fix common problems
• Find and recommend ClawHub skills
• Run extended health checks
• Setup OpenClaw for first time
• Update documentation and caches

Available Tools

Error Fixer

Diagnose and auto-fix OpenClaw errors.

# Diagnose by error code
python3 {baseDir}/scripts/error-fixer.py --error 401

# Analyze log file
python3 {baseDir}/scripts/error-fixer.py --input /path/to/log

# Auto-fix safe issues
python3 {baseDir}/scripts/error-fixer.py --error EADDRINUSE --auto-fix

# List errors by category
python3 {baseDir}/scripts/error-fixer.py --category authentication

Skill Recommender

Smart ClawHub skill recommendations.

# Recommend for channel
python3 {baseDir}/scripts/skill-recommender.py --channel whatsapp --top 5

# Recommend by use case
python3 {baseDir}/scripts/skill-recommender.py --use-case "image generation"

# Auto-detect from config
python3 {baseDir}/scripts/skill-recommender.py --auto-detect

# Check for updates
python3 {baseDir}/scripts/skill-recommender.py --check-updates

Enhanced Doctor

Extended diagnostic checks.

# Full diagnostics
python3 {baseDir}/scripts/enhanced-doctor.py

# Deep scan with log analysis
python3 {baseDir}/scripts/enhanced-doctor.py --deep

# JSON output
python3 {baseDir}/scripts/enhanced-doctor.py --json

Self-Updater

Keep references and caches current.

# Check what's outdated
python3 {baseDir}/scripts/self-updater.py --check

# Update everything
python3 {baseDir}/scripts/self-updater.py --update

# Update only skill cache
python3 {baseDir}/scripts/self-updater.py --update --skills-only

Setup Wizard

Interactive first-time setup.

# Interactive setup
python3 {baseDir}/scripts/setup-wizard.py

# Check prerequisites only
python3 {baseDir}/scripts/setup-wizard.py --check-only

Reference Files

• Error Catalog - Master error index
• Auto-Fix Capabilities - Safe vs manual fixes
• Diagnostic Commands - CLI quick reference
• Troubleshooting Workflow - Decision tree
• Authentication Errors - Auth issues
• Rate Limiting Errors - Quota management
• Gateway Errors - Network issues
• Channel Errors - Channel-specific
• Sandbox Errors - Docker issues
• Configuration Errors - Config problems
• Installation Errors - Setup issues
• ClawHub Integration - Skill management

Templates

• Error Report - Diagnostic output format
• Recommendation Report - Skill suggestions format