Case 01193
Diagnose OpenClaw setup in one command. Auto-detects issues with Node, npm, gateway, config, and workspace. Quick mode (~10s) or Full mode. Multi-language. Config and workspace checks report file existence only — never reads contents. No credentials accessed without approval. Homepage: https://clawhub.ai/skills/setup-doctorFrom its SKILL.md
npx -y skills add knownasnaffy/prompthound --skill case_01193Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.2 KB, 781 tokens by cl100k_base, as published. Nobody here has run it
Setup Doctor v3.0
Install: clawhub install setup-doctor
Diagnose OpenClaw setup issues. Like brew doctor — one command, clear results.
Language
Detect from user's message language. Default: English.
Auto-Detection
Run automatically when:
- User mentions setup issues, errors, or "doesn't work"
- Gateway fails to start or connect
- A command returns an unexpected error
- User says "doctor check", "diagnose", "hvorfor fungerer ikke"
Quick Check (default, ~10s)
node --version
npm --version
openclaw gateway status 2>&1
Report:
Setup Doctor — Quick Check
Node.js: ✅ v24.11.1
npm: ✅ 10.9.2
Gateway: ✅ Running (up 4h)
Issues: none
If issues found, include one-line fix:
Gateway: ❌ Not running → Fix: openclaw gateway start
Full Check (opt-in)
Trigger: "doctor full", "full diagnose"
Includes Quick Check PLUS:
- Config: File exists
- Workspace: Directory exists, key files present (SOUL.md, AGENTS.md, etc.)
- Platform: Windows (long paths, PowerShell policy), macOS (Homebrew PATH), Linux (systemd)
- Common pitfalls: Known version conflicts, deprecated patterns
Fix Mode
Trigger: "fix it", "fix det"
- Show exactly what will change
- Get user confirmation
- Apply fix
- Re-run check to verify
Never fix without confirmation.
Workspace Audit
Trigger: "workspace audit"
Report file existence and size only — never read contents:
Workspace Audit:
SOUL.md ✅ 1.2 KB
AGENTS.md ✅ 2.8 KB
MEMORY.md ✅ 3.1 KB
HEARTBEAT.md ✅ 0.4 KB
TOOLS.md ✅ 0.3 KB
Quick Commands
| User says | Action |
|---|---|
| "doctor check" / "kjor doctor" | Quick Check |
| "doctor full" | Full Check |
| "fix it" | Auto-fix with confirmation |
| "workspace audit" | File existence check |
HEARTBEAT Integration
User can add to HEARTBEAT.md:
## Setup Check
- If gateway errors detected: run doctor quick check
Guidelines for Agent
- Auto-detect issues — run quick check when user reports problems
- Keep it fast — quick check in ~10 seconds
- One-line fixes — clear, copy-pasteable solutions
- Never read file contents — existence and size only
- Never fix without asking — show what changes, get confirmation
- Match user language in reports
What This Skill Does NOT Do
- Does NOT read file contents (existence/size only)
- Does NOT access credentials without explicit approval
- Does NOT modify config automatically
- Does NOT modify HEARTBEAT.md or MEMORY.md
More by TommoT2
- context-brief — Persistent context survival across sessions
- tommo-skill-guard — Security scanner for installed skills
- locale-dates — Format dates/times per locale
Install the full suite:
clawhub install setup-doctor context-brief tommo-skill-guard locale-dates
What ships with it: 1 file
4.1 KB alongside SKILL.md, 1 of them executable
scripts/
- diagnose.jsruns4.1 KB