SkillHub

transparent-heart-openclaw-workspace-doctor

v0.1.0

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.

Sourced from ClawHub, Authored by transparent-heart

Installation

Please help me install the skill `transparent-heart-openclaw-workspace-doctor` from SkillHub official store. npx skills add transparent-heart/transparent-heart-openclaw-workspace-doctor

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:

  6. README.md
  7. pyproject.toml
  8. setup.py
  9. tests/

  10. .github/workflows/ci.yml

  11. Validate before closing:

  12. python3 -m unittest discover -s tests
  13. python3 scripts/workspace_doctor.py
  14. python3 scripts/workspace_doctor.py --json
  15. 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.