setup-doctor-pro v1.0

Released: 2026-04-29

Price: $4.99

Category: operations

Security Audit: CLEARED ✅ — Warlock 2026-04-29 (repackaged; stale pycache removed)

QA: APPROVED_FOR_RELEASE ✅ — Viper 2026-04-29

What it does

Setup Doctor Pro is a read-only OpenClaw installation diagnostic tool. Run it when setup is broken, gateway state looks stale, tools are disappearing, costs look wrong, or you simply need a first-pass health report before changing configuration.

It checks workspace layout, required files, Python/Git/Node binary availability, skill manifests, memory file size, pipeline handoff files, config file permissions, and empty/stale state files — then returns a 0–100 score and a status of pass (≥85) or attention_required.

Every check is non-destructive. The tool produces evidence and recommended next steps; it never modifies files.

Key capabilities

Workspace layout checks — verifies presence of MEMORY.md, AGENTS.md, skills/, and memory/
Skill manifest validation — finds skill folders missing SKILL.md and lists them
Memory file size audit — flags MEMORY.md over 5,000 bytes with a recommendation to archive details
Pipeline file presence — checks for memory/release-pipeline.md and memory/viper-test-queue.md
Binary availability — confirms python3, git, and node are in PATH
Config file permissions — optionally validates a supplied --config path exists and is owner-only
Stale state file detection — finds zero-byte .pid, .sock, gateway*.json, and session*.json files
Scoring model — critical=−35, high=−20, medium=−10, low=−3; score=100 means no findings; ≥85=pass
JSON output mode — --json flag for machine-readable output, CI integration, and audit trails

Severity model

| Severity | Penalty | Triggers |

|----------|---------|----------|

| critical | −35 | Workspace directory does not exist |

| high | −20 | Missing MEMORY.md, AGENTS.md, skills/, memory/; missing binary; missing --config file |

| medium | −10 | Skill folder missing SKILL.md; MEMORY.md oversized; config permissions too open |

| low | −3 | Missing pipeline handoff files; empty state files |

Use cases

First-pass health check — run before any configuration change to establish a baseline score
Post-install validation — confirm new OpenClaw installs are complete and healthy
Debugging broken setups — when skills disappear or gateway state seems stale, check here first
Team onboarding — give new operators a one-command overview of installation health
Pipeline pre-flight — run at the top of any maintenance window to confirm environment is sound before proceeding

Requirements

Python 3.10+
Python standard library only — no pip install required
No API keys required
Read-only filesystem access (exists, stat mode, file size — no file content reads)

Example usage

Standard diagnostic scan


python3 skills/setup-doctor-pro/scripts/setup_doctor_pro.py \
  --workspace /root/.openclaw/workspace

Expected output (healthy system):


Setup Doctor score: 90 (pass)

Expected output (issues found):


Setup Doctor score: 70 (attention_required)
[high] missing_MEMORY.md: Missing MEMORY.md -> Restore from backup or re-run setup.
[medium] skill_missing_manifest: Skill folders without SKILL.md: my-broken-skill -> Add SKILL.md or remove stale folders.

JSON output for CI / audit trail


python3 skills/setup-doctor-pro/scripts/setup_doctor_pro.py \
  --workspace /root/.openclaw/workspace --json

Expected JSON shape:


{
  "generated_at": "2026-04-29T09:00:00+00:00",
  "workspace": "/root/.openclaw/workspace",
  "findings": [],
  "score": 100,
  "status": "pass"
}

With optional config file validation


python3 skills/setup-doctor-pro/scripts/setup_doctor_pro.py \
  --workspace /root/.openclaw/workspace \
  --config /root/.openclaw/openclaw.json \
  --json

Security notes

No credential reads: the tool checks file existence and stat mode (permissions) only — it never reads the content of openclaw.json, .env, or any credentials file
No writes, no side effects: purely diagnostic — no files created, modified, or deleted
No network calls: confirmed by Warlock strace — no INET/INET6 connections at any execution path
stdlib only: no third-party dependencies

QA and security clearance

Viper QA: APPROVED_FOR_RELEASE 2026-04-29 — all diagnostic checks verified, JSON output valid, score model confirmed
Warlock security audit: SECURITY_CLEARED 2026-04-29 — stale pycache removed from landing zip and repackaged; 0 critical, 0 high, 0 medium, 0 low findings; no eval/exec, no network imports, no credential content reads; strace confirmed no network activity; SHA-256 checksums regenerated and verified

Marketing copy

Setup Doctor Pro is the first thing to run when your OpenClaw setup isn't behaving — and the last thing to run before you start changing it. One command checks workspace layout, skill manifests, required binaries, memory file health, pipeline files, config permissions, and stale state — then returns a clear 0–100 score and a prioritised finding list with fix suggestions. Read-only and stdlib-only: no pip install, no API keys, no risk of making things worse. Whether you're onboarding a new install, debugging a broken gateway, or just want evidence before a maintenance window, Setup Doctor Pro gives you the baseline in seconds.

Setup Doctor Pro