← Back to Skills Marketplace
oc-doctor
by
bryant24hao
· GitHub ↗
· v1.1.0
· MIT-0
403
Downloads
1
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install oc-doctor
Description
Runs a comprehensive 11-section health check on local OpenClaw installations. Diagnoses configuration errors, session bloat, model drift, cron issues, securi...
Usage Guidance
This skill appears coherent and local-only, but before installing or running: 1) confirm you trust the skill source (README points to a GitHub repo); 2) review which local files will be read (openclaw.json, models.json, sessions.json, workspace .md, logs) and back them up if needed; 3) be aware that diagnostic output is included in LLM conversation context — sensitive values might be redacted but verify redaction on a small test first; 4) grant fixes only after reviewing the proposed changes (batch-fix can modify config/files); and 5) prefer installing from the official repo or a vetted registry to avoid supply-chain risk.
Capability Analysis
Type: OpenClaw Skill
Name: oc-doctor
Version: 1.1.0
The skill is a diagnostic utility for OpenClaw that requires high-risk permissions, including reading configuration files containing sensitive API keys (openclaw.json) and executing a bundled shell script (sysinstruction-check.sh). While the logic is consistent with its stated purpose and includes explicit instructions for the AI agent to redact secrets from its output, the broad access to credentials and the use of shell execution for data collection are significant risk factors. No evidence of intentional malice, data exfiltration, or unauthorized network activity was found.
Capability Assessment
Purpose & Capability
Name/description match the actions: the skill needs openclaw and jq and reads OpenClaw config, sessions, models, workspace files to produce diagnostics. The single included shell script is a local data-collector used by the LLM analysis, which is coherent with the stated purpose.
Instruction Scope
SKILL.md instructs the agent to run openclaw commands and read many OpenClaw files (openclaw.json, models.json, sessions.json, workspace .md, logs, cron configs) — all within the stated diagnostic scope. One notable instruction is language inference that explicitly says to check recent conversation history and workspace file content; this expands the data the agent may access (conversation context and workspace files) for language detection and could surface sensitive context into the LLM conversation. The skill states fixes will only run with explicit confirmation, which limits surprise modifications.
Install Mechanism
No install spec is provided (instruction-only plus a single included script). No network downloads or archive extraction occur as part of the skill bundle itself, so installation risk is low — risk depends on how the user obtains the skill (e.g., cloning from an external repo).
Credentials
The skill does not request credentials or additional environment variables beyond an optional OPENCLAW_HOME. It does read local files that can contain sensitive values (models.json, sessions.json, workspace files). The README/SKILL.md claims secrets are redacted in reports (first 8 chars + ...), which is reasonable, but users should verify redaction behavior before sharing outputs beyond their machine.
Persistence & Privilege
The skill is not force-included (always: false) and does not request persistent system-level privileges. The included script declares no writes and the SKILL.md states modifications happen only after explicit confirmation. Autonomous invocation is allowed by default (disable-model-invocation: false) which is normal for skills; combined with the limited local scope this is acceptable.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install oc-doctor - After installation, invoke the skill by name or use
/oc-doctor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Unify skill name to oc-doctor across all platforms
v1.0.0
Initial release: 11-section OpenClaw health check with interactive fixes, cross-reference integrity, auto language, and secret redaction.
Metadata
Frequently Asked Questions
What is oc-doctor?
Runs a comprehensive 11-section health check on local OpenClaw installations. Diagnoses configuration errors, session bloat, model drift, cron issues, securi... It is an AI Agent Skill for Claude Code / OpenClaw, with 403 downloads so far.
How do I install oc-doctor?
Run "/install oc-doctor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is oc-doctor free?
Yes, oc-doctor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does oc-doctor support?
oc-doctor is cross-platform and runs anywhere OpenClaw / Claude Code is available (macos, linux).
Who created oc-doctor?
It is built and maintained by bryant24hao (@bryant24hao); the current version is v1.1.0.
More Skills