A specialized diagnostic engine designed to triage and resolve command execution failures, shell errors, and API schema mismatches.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install exec-error-doctor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install exec-error-doctor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Exec Error Doctor?
Exec Error Doctor is a robust utility designed to eliminate the guesswork involved in command-line failures. It provides developers using Openclaw Skills with a systematic way to diagnose non-zero exit codes, signal kills, missing binaries, and complex JSON field mismatches. Instead of performing random retries, this skill classifies the root cause and suggests targeted fixes.
By leveraging a predefined error taxonomy, Exec Error Doctor handles specific platform quirks, such as GitHub CLI schema drift and ClawHub visibility lags. It ensures that transient errors are met with intelligent backoffs while hard errors like authentication or permission issues are flagged immediately for human or agent intervention.
Exec Error Doctor Use Cases
- Triaging raw error text from failed shell commands or automation scripts.
- Resolving schema drift issues when using GitHub CLI search functions.
- Managing transient 'Skill not found' errors immediately following a ClawHub publish action.
- Automating the distinction between transient platform states and permanent configuration errors.
How Exec Error Doctor Works
- The user or agent feeds raw error text or a log file into the triage script.
- The system analyzes the input against a pattern-based classifier to identify the error category.
- A specific remediation strategy is selected from the internal error taxonomy map.
- If a safe wrapper is available (e.g., for GitHub or ClawHub), the command is re-executed using resilient logic to ensure success.
Exec Error Doctor Setup
To integrate this skill into your workflow, ensure the scripts are executable within your environment:
# Navigate to the skill directory
cd skills/exec-error-doctor
# Run the triage tool on a specific error message
bash scripts/exec_error_triage.sh "Unknown JSON field: nameWithOwner"
Exec Error Doctor Data Schema & Taxonomy
The skill utilizes a structured reference system to manage error logic and remediation steps:
| Component | Description |
|---|---|
references/error-taxonomy.md |
A comprehensive map linking error categories to specific fixes. |
scripts/exec_error_triage.sh |
The primary classification engine for pattern matching. |
scripts/gh_search_repos_safe.sh |
A wrapper that substitutes unstable fields (like nameWithOwner) with stable ones (fullName). |
scripts/clawhub_publish_safe.sh |
A verification wrapper that handles post-publish visibility checks. |
Exec Error Doctor Advanced Features
- Intelligent classification of transient vs. permanent execution failures.
- Specialized GitHub CLI search wrappers that automatically correct schema drift.
- ClawHub publish-and-verify logic to account for platform replication lag.
- Pattern-based error detection for common Openclaw Skills execution environments.
SKILL.md
Loading
Related Openclaw Skills
swift-patterns
A comprehensive framework for building, reviewing, and refactoring SwiftUI applications using Apple-native best practices and modern API standards.
depo-bot
A specialized AI skill that converts deposition transcripts into comprehensive strategic memos, witness analyses, and trial-ready examination outlines.
Gousto Meal Picker
A smart automation tool for Gousto customers that selects weekly meal kits based on custom dietary rules and nutritional preferences.
ClawMarket
The first decentralized marketplace designed specifically for AI agents to trade products and services using crypto payments.
IPFS Client
A read-only assistant for fetching and exploring IPFS and IPNS content via gateways or local nodes.
Training Manager
A comprehensive workspace management tool for Openclaw Skills designed to scaffold, log, and validate AI agent behaviors and memories.
Featured*
