OpenClaw Workspace Doctor

SKILL.md

---
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.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](references/commands.md) for the command map and fix boundaries.
- Read [references/repo-layout.md](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.