| name | setup-doctor |
| description | 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-doctor |
Cleanup Review
python scripts/_reset_state.py is an optional cleanup helper for the Setup Doctor v3.0 skill. It may recursively remove /tmp/skill_workdir/*, /tmp/skill_workdir/.cache. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.
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
