How do I install the Setup Doctor skill?

Run npx skillmds@latest add knownasnaffy/setup-doctor-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Setup Doctor safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Setup Doctor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Setup Doctor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Setup Doctor?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Setup Doctor by knownasnaffy — Agent Skill

Name: Setup Doctor
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Setup Doctor

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

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

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

---name: setup-doctor-3description: 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---# Setup Doctor v3.0**Install:** `clawhub install setup-doctor`Diagnose OpenClaw setup issues. Like `brew doctor` — one command, clear results.## LanguageDetect from user's message language. Default: English.## Auto-DetectionRun 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)```bashnode --versionnpm --versionopenclaw 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 ModeTrigger: "fix it", "fix det"1. Show exactly what will change2. Get user confirmation3. Apply fix4. Re-run check to verify**Never fix without confirmation.**## Workspace AuditTrigger: "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 IntegrationUser can add to HEARTBEAT.md:```markdown## Setup Check- If gateway errors detected: run doctor quick check```## Guidelines for Agent1. **Auto-detect issues** — run quick check when user reports problems2. **Keep it fast** — quick check in ~10 seconds3. **One-line fixes** — clear, copy-pasteable solutions4. **Never read file contents** — existence and size only5. **Never fix without asking** — show what changes, get confirmation6. **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 localeInstall the full suite:```bashclawhub install setup-doctor context-brief tommo-skill-guard locale-dates```

Frequently asked questions