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

1. If the problem is workspace-local, apply safe fixes:

python3 scripts/workspace_doctor.py --fix

1. 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

1. 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

1. For repo packaging tasks, update:
• README.md
• pyproject.toml
• setup.py
• tests/
• .github/workflows/ci.yml

1. 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.