OpenClaw Setup Friction Doctor — v1.0

Category: automation

Price: $4.99

Released: 2026-08-06

---

What it does

OpenClaw Setup Friction Doctor triages setup blockers from operator-provided local notes, covering Docker port conflicts, dependency version drift, environment variable naming gaps, service readiness signals, and messaging-channel configuration issues. It reads notes only — no APIs, no live services, no config mutations — and returns a deterministic PASS / REVIEW / BLOCKED JSON report with scored evidence and actionable recommendations.

---

Use cases

• Validate environment readiness before a new OpenClaw deployment, surfacing Docker, dependency, and env-var blockers before they stall go-live.
• Audit messaging-channel and service-readiness configuration gaps in pre-production notes without spinning up a live environment.
• Give on-call engineers a fast, repeatable triage checklist for setup failures that converts vague friction reports into concrete BLOCKED signals with fix hints.

---

Requirements

• Python 3.8+
• Standard library only (argparse, json, re, pathlib) — no pip dependencies, no network access, no external services.

---

Example usage

# Triage from a notes file
python3 scripts/setup_friction_doctor.py --notes /path/to/setup-notes.md --json

# Triage inline text
python3 scripts/setup_friction_doctor.py --text "Port 5432 already bound; OPENCLAW_API_KEY missing" --json

# Run built-in self-test
python3 scripts/setup_friction_doctor.py --self-test --json

Expected output:

{
  "status": "BLOCKED",
  "score": 34,
  "evidence": ["port_conflict: 5432", "missing_env_var: OPENCLAW_API_KEY"],
  "recommendations": ["Free port 5432 or update Docker compose port mapping", "Set OPENCLAW_API_KEY in .env before launch"],
  "mutated_files": []
}

Self-test returns ok: true, clean fixture PASS, risky fixture BLOCKED, and mutated_files: [].