← Back to Skills Marketplace
OpenClaw Workspace Doctor
by
transparent-heart
· GitHub ↗
· v0.1.0
· MIT-0
279
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install transparent-heart-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...
Usage Guidance
Do not run these scripts on your main machine yet. The repo/instructions are inconsistent: SKILL.md refers to scripts/workspace_doctor.py and fix_openclaw_codex_config.py but the package contains run_doctor.py and fix_openclaw_config.py; wrappers import a src/workspace_doctor package that is not present. Before using: 1) Ask the publisher for the missing src/ files or a corrected package. 2) Inspect the full implementation of src/workspace_doctor/* to confirm no hidden network endpoints or exfil logic. 3) Run the fixer in a disposable/sandbox environment (or with the --stdout option if available) to verify output before allowing it to write to ~/.openclaw/openclaw.json. 4) Confirm the script creates a timestamped backup as promised. If the author cannot explain the missing files and mismatched names, do not install or run the skill.
Capability Analysis
Type: OpenClaw Skill
Name: transparent-heart-openclaw-workspace-doctor
Version: 0.1.0
The skill bundle is classified as suspicious because it explicitly instructs the agent to modify configuration files outside the workspace (specifically `~/.openclaw/openclaw.json`) and utilizes risky path manipulation. The scripts `scripts/run_doctor.py` and `scripts/fix_openclaw_config.py` attempt to import code from directories three levels above the script's location (`parents[3]`), which is a potential sandbox escape or dependency on an external environment. Furthermore, `SKILL.md` contains a hardcoded absolute path to a specific user's directory (`/Users/xutao/`), suggesting it may be tailored for a specific target or environment rather than being a generic, safe tool.
Capability Assessment
Purpose & Capability
The declared purpose (workspace inspection/repair and an external OpenClaw config fixer) matches the higher-level instructions to run a doctor and to patch ~/.openclaw/openclaw.json. However the SKILL.md commands reference scripts named scripts/workspace_doctor.py and scripts/fix_openclaw_codex_config.py while the repo actually contains scripts/run_doctor.py and scripts/fix_openclaw_config.py. The skill also references a src/workspace_doctor package (in wrappers and repo-layout) but no src/ tree or package files are present in the manifest. These inconsistencies mean the skill as packaged cannot perform its claimed function without additional missing files.
Instruction Scope
Instructions explicitly instruct writing/patching the user-level config at ~/.openclaw/openclaw.json (with backups and a --stdout safe mode). That behavior is within the described purpose but is high-impact (modifies files outside the workspace and the user home). The SKILL.md also includes a hard-coded example path (/Users/xutao/...) and references repo commands that don't match actual filenames; the workflow assumes code under src that isn't included in the package.
Install Mechanism
No install specification — instruction-only with small Python wrapper scripts. This is low-risk from an installer perspective because nothing is automatically downloaded or written by an install step.
Credentials
The skill does not declare or request any environment variables or credentials. The only sensitive operation is writing to a user home config file (~/.openclaw/openclaw.json), which is coherent with the stated purpose but should be explicitly confirmed by a user before running.
Persistence & Privilege
The skill is not force-included (always: false) and does not request special platform privileges. However it is designed to modify a user-level persistent config file (~/.openclaw/openclaw.json). Combined with the packaging inconsistencies, this raises risk: a user running a mismatched or tampered fixer could unintentionally change their global OpenClaw configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install transparent-heart-openclaw-workspace-doctor - After installation, invoke the skill by name or use
/transparent-heart-openclaw-workspace-doctor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial public release.
Metadata
Frequently Asked Questions
What is OpenClaw Workspace Doctor?
Use when the user wants to inspect, repair, package, or troubleshoot an OpenClaw workspace doctor setup, especially for stale bootstrap state, missing daily... It is an AI Agent Skill for Claude Code / OpenClaw, with 279 downloads so far.
How do I install OpenClaw Workspace Doctor?
Run "/install transparent-heart-openclaw-workspace-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Workspace Doctor free?
Yes, OpenClaw Workspace Doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Workspace Doctor support?
OpenClaw Workspace Doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Workspace Doctor?
It is built and maintained by transparent-heart (@transparent-heart); the current version is v0.1.0.
More Skills