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)#

bash

node --version
npm --version
openclaw gateway status 2>&1

Report:

text

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:

text

  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"

1. Show exactly what will change
2. Get user confirmation
3. Apply fix
4. Re-run check to verify

Never fix without confirmation.

Workspace Audit#

Trigger: "workspace audit"

Report file existence and size only — never read contents:

text

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 saysAction"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:

markdown

## Setup Check
- If gateway errors detected: run doctor quick check

Guidelines for Agent#

1. Auto-detect issues — run quick check when user reports problems
2. Keep it fast — quick check in ~10 seconds
3. One-line fixes — clear, copy-pasteable solutions
4. Never read file contents — existence and size only
5. Never fix without asking — show what changes, get confirmation
6. 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:

bash

clawhub install setup-doctor context-brief tommo-skill-guard locale-dates