Overview
Windows Desktop Onboarding Doctor turns Windows setup friction into a clear diagnostic and action plan. Instead of sending Windows users into a Linux terminal, this skill inspects their setup folder or support bundle and returns a structured JSON report covering prerequisites, WSL friction points, shortcut recommendations, admin requirements, and remediation steps.
Default mode is read-only and report-only — it never modifies OpenClaw configuration, PATH, registry, or services. Three profiles (beginner, developer, enterprise) tailor the recommendations to the user’s context, and admin steps are always separated from normal-user steps so elevated actions are never mixed in with routine guidance.
Key Features
- WSL friction detection — surfaces Linux-only setup steps and suggests native PowerShell alternatives
- Environment prerequisite checks: Node.js LTS, Git for Windows, OpenClaw/Hermes presence
- Start Menu and Desktop shortcut manifest generation for launch, status, and repair actions
- Three profiles:
beginner,developer,enterprise— tailored recommendations per context - Admin vs. normal-user step separation — elevated requirements called out explicitly
- JSON output for piping into support workflows, ticketing systems, or handoff docs
.envfiles excluded by default — opt-in via--include-sensitivefor offline/isolated use only- No network calls, no subprocess execution, stdlib-only — zero pip installs
Use Cases
- Support teams: generate consistent diagnostic reports from user-submitted setup bundles
- Onboarding workflows: identify and document Windows-specific blockers before first-run
- Enterprise deployments: separate admin prerequisites from normal-user steps for staged rollouts
- Developer tooling: surface WSL dependency and shortcut gaps in CI/CD onboarding validation
Example Usage
# Basic diagnostic on a setup export
python3 scripts/windows_desktop_onboarding_doctor.py ./setup-bundle --output report.json
# Developer profile
python3 scripts/windows_desktop_onboarding_doctor.py ./setup-bundle --profile developer --output report.json
# Enterprise profile with output file
python3 scripts/windows_desktop_onboarding_doctor.py ./support-bundle --profile enterprise --output enterprise-report.json
Security Boundary
.envfiles are excluded by default — use--include-sensitiveonly for offline/isolated diagnostic bundles- Raw secret values are never emitted in output even when
--include-sensitiveis active — only boolean signal flags are reported - The skill does not execute shell commands, make network calls, or read outside the supplied path
- Sensitive file scan output carries a security warning header when active
Requirements
- OpenClaw v2026.3.23 or later
- Python 3.8+ (stdlib only — no pip installs required)
- No API keys