OpenClaw Workspace Doctor

Use when the user wants to inspect, repair, package, or troubleshoot an OpenClaw workspace doctor setup, especially for stale bootstrap state, missing daily...

Overview

This skill runs the OpenClaw workspace doctor, applies safe workspace-local fixes, and handles the companion fixer for the external codex-cli backend config. Use it when the user asks to diagnose workspace startup drift, package the doctor tool, or repair the known --full-auto non-interactive stall risk.

When To Use It

• The user asks to run or extend the workspace doctor tool.
• The workspace has stale bootstrap/onboarding behavior.
• Daily memory/YYYY-MM-DD.md notes are missing or inconsistent.
• OpenClaw is hanging because codex-cli launches with --full-auto.
• The user wants the doctor packaged as a repo or a Codex skill.

Workflow

1. Run the doctor first: python3 scripts/workspace_doctor.py

2. If the problem is workspace-local, apply safe fixes: python3 scripts/workspace_doctor.py --fix

3. If the remaining problem is the external OpenClaw config, inspect or patch it with the companion fixer: python3 scripts/fix_openclaw_codex_config.py --check python3 scripts/fix_openclaw_codex_config.py

4. If the environment blocks writing ~/.openclaw/openclaw.json, do not pretend the live fix happened. Report the sandbox restriction clearly and, if useful, use: python3 scripts/fix_openclaw_codex_config.py --stdout

5. For repo packaging tasks, update:

   • README.md
   • pyproject.toml
   • setup.py
   • tests/
   • .github/workflows/ci.yml

6. Validate before closing:

   • python3 -m unittest discover -s tests
   • python3 scripts/workspace_doctor.py
   • python3 scripts/workspace_doctor.py --json
   • python3 /Users/xutao/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/openclaw-workspace-doctor

Repo Commands

• Run doctor: python3 scripts/workspace_doctor.py
• Run doctor with fixes: python3 scripts/workspace_doctor.py --fix
• Emit JSON: python3 scripts/workspace_doctor.py --json
• Check external config: python3 scripts/fix_openclaw_codex_config.py --check
• Patch external config: python3 scripts/fix_openclaw_codex_config.py
• Print patched config without writing: python3 scripts/fix_openclaw_codex_config.py --stdout

References

• Read references/commands.md for the command map and fix boundaries.
• Read references/repo-layout.md when you need the repo structure and what each area is for.

Scripts

• scripts/run_doctor.py runs the packaged CLI.
• scripts/fix_openclaw_config.py runs the external config fixer.
• Prefer these wrappers or the repo-root scripts instead of retyping logic.