OpenClaw Whisperer

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

What's New in v1.1.0

Complementary Skills - Discover skills that work together (10 skill relationships)
Diagnostic Hooks - GitHub/Slack/Discord integration for error notifications (9 hook configs)
Recovery Tracking - Track fix execution history and success rates
Smart Scoring - Enhanced recommendations with complementary skill bonus scoring
Rich Display - Improved CLI panels and formatting for suggestions

When to Use

Activate when user wants to:

Diagnose OpenClaw errors or issues
Auto-fix common problems
Find and recommend ClawHub skills with complementary suggestions
Run extended health checks
Setup OpenClaw for first time
Update documentation and caches
Track fix execution history

Available Tools

Error Fixer

Diagnose and auto-fix OpenClaw errors with diagnostic hooks and recovery tracking.

# Diagnose by error code (triggers diagnostic hooks if configured)
python3 {baseDir}/scripts/error-fixer.py --error 401

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

# Auto-fix safe issues (tracks execution history)
python3 {baseDir}/scripts/error-fixer.py --error EADDRINUSE --auto-fix

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

# View fix execution history
python3 {baseDir}/scripts/error-fixer.py --show-history

# Test notification hooks (GitHub/Slack/Discord)
python3 {baseDir}/scripts/error-fixer.py --test-hooks

Skill Recommender

Smart ClawHub skill recommendations with complementary skill detection.

# Recommend for channel (includes complementary skills)
python3 {baseDir}/scripts/skill-recommender.py --channel whatsapp --top 5

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

# Auto-detect from config (enriched with complementary metadata)
python3 {baseDir}/scripts/skill-recommender.py --auto-detect

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

# View complementary skills for installed skill
python3 {baseDir}/scripts/skill-recommender.py --complementary-for image-generator-pro

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

Data Files (v1.1.0)

complementary-skills.json - 10 skill relationships
integration-hooks.json - 9 notification hook configs
fix-execution-history.json - Fix tracking metadata

Templates

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

openclaw-whisperer