| name | exec-error-doctor |
| description | Diagnose and mitigate exec-related command failures across tools (OpenClaw exec output, shell errors, GitHub CLI, ClawHub CLI, missing binaries, auth failures, JSON field mismatch, permission errors, timeouts, and transient platform states). Use when a command returns non-zero, signal kill, ENOENT, unknown JSON field, or similar execution failures and you need fast triage + concrete next fixes. |
Exec Error Doctor
Triage execution failures quickly, classify root cause, and apply targeted fixes instead of random retries.
Quick workflow
- Run triage on raw error text:
scripts/exec_error_triage.sh <error_text_or_file>
- Apply the category fix from
references/error-taxonomy.md.
- Re-run with safer wrappers when relevant:
- GitHub CLI search schema drift:
scripts/gh_search_repos_safe.sh
- ClawHub publish visibility lag:
scripts/clawhub_publish_safe.sh
- Confirm with one clean re-run and capture outcome.
Standard commands
Generic triage
bash scripts/exec_error_triage.sh "Unknown JSON field: nameWithOwner"
Safe GitHub repo search (schema-aware)
bash scripts/gh_search_repos_safe.sh "safe-exec skill" 15
Safe ClawHub publish (retry-aware inspect)
bash scripts/clawhub_publish_safe.sh ./my-skill my-skill "My Skill" 1.0.0 "Initial release"
Rules
- Prefer classification before fixes.
- Treat
Skill not found right after publish as potentially transient if publish already returned OK.
- For
gh search repos --json, prefer fullName (not nameWithOwner).
- Distinguish transient errors (retry/backoff) from hard errors (auth, permission, invalid args).
Resources
references/error-taxonomy.md: category→fix map.scripts/exec_error_triage.sh: pattern-based classifier.scripts/gh_search_repos_safe.sh: resilient GitHub search wrapper.scripts/clawhub_publish_safe.sh: publish + retry verification wrapper.
