OpenClaw Workspace Doctor

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.