- name
- openclaw-workspace-doctor
- description
- Use when the user wants to inspect, repair, package, or troubleshoot an OpenClaw workspace doctor setup, especially for stale bootstrap state, missing daily memory notes, or codex-cli launch hazards in OpenClaw config.
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.mdnotes are missing or inconsistent. - OpenClaw is hanging because
codex-clilaunches with--full-auto. - The user wants the doctor packaged as a repo or a Codex skill.
Workflow
- Run the doctor first:
python3 scripts/workspace_doctor.py
- If the problem is workspace-local, apply safe fixes:
python3 scripts/workspace_doctor.py --fix
- 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
- 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
- For repo packaging tasks, update:
- README.md - pyproject.toml - setup.py - tests/ - .github/workflows/ci.yml
- 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.pyruns the packaged CLI.scripts/fix_openclaw_config.pyruns the external config fixer.- Prefer these wrappers or the repo-root scripts instead of retyping logic.