PhenixStarPhenixStar/openclaw-skills-collection/openclaw-whisperer/SKILL.md

openclaw-whisperer

Skill1 starsChanged 9 months agoMITView on GitHub

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

Installs packages

In this repository3 other files it gives its agents.
- openclaw-backupSkill
- skill-hubSkill
- skill-vettingSkill

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Run extended health checks
line 41
Distinctive:
Update documentation and caches
line 43
Distinctive:
Keep references and caches current.
line 103

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free