johnalbertini14-glitch 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