oc-doctor

What This Skill Does

oc-doctor is the definitive diagnostic utility for OpenClaw local installations. It automates the maintenance of your environment by performing a rigorous 11-section health check. The tool scans your configuration files, session directories, and cron job schedules to identify inconsistencies, security holes, and performance bottlenecks. By executing a deep analysis of your local state, it detects critical issues like configuration drifts, obsolete legacy files, and insecure gateway settings that could expose your agent to unauthorized access. The skill produces a human-readable report categorized by CRITICAL, WARNING, and INFO levels, and provides interactive, one-click solutions to resolve identified errors. Whether you are debugging a stalled session or optimizing your token budget, oc-doctor ensures your OpenClaw agent remains performant, secure, and fully operational.

Installation

You can install the skill directly via the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/bryant24hao/oc-doctor

Ensure that you have jq installed on your system before running the doctor utility, as it is a mandatory dependency for parsing the configuration reports.

Use Cases

• Post-Update Verification: Run the doctor after updating your OpenClaw version to ensure all configuration schemas match the latest requirements.
• Performance Bottleneck Resolution: If your agent response time is lagging, use the doctor to diagnose session bloat and identify cron job conflicts.
• Security Auditing: Regularly check your Telegram and Feishu channel configurations to ensure your requireMention and groupPolicy settings are not inadvertently exposing your agent.
• Automated Cleanup: Use the doctor to identify and remove legacy configuration files (*.bak*) that clutter your environment.

Example Prompts

1. "openclaw doctor: run a full diagnostic on my current installation."
2. "claw health check - are there any critical security issues with my channel configuration?"
3. "claw diagnose: why is my agent using too many tokens for system instructions?"

Tips & Limitations

• Context Awareness: The tool automatically detects your OPENCLAW_HOME directory, so you do not need to manually configure environment variables.
• Multilingual Support: The tool intelligently detects your language based on your workspace files and interaction history, providing localized reports.
• Safety Note: While the skill offers 'one-click fixes,' always review the proposed changes for complex configuration files. The doctor does not delete active session data without explicit user confirmation during the interactive fix phase.