Openclaw Diagnostics

What This Skill Does

OpenClaw Diagnostics is a specialized expert skill developed by cooperun designed to streamline the troubleshooting and maintenance of your OpenClaw environment. Rather than manually inspecting complex log files or navigating through deep system configurations, this skill acts as an intelligent assistant that automatically identifies bottlenecks, configuration errors, and connectivity failures. It leverages a local, built-in knowledge base containing 335 indexed documentation pages, ensuring that troubleshooting happens entirely offline and within your local infrastructure. By automating the data-gathering process and providing clear, actionable steps for resolution, it drastically reduces the mean time to repair (MTTR) for common OpenClaw issues such as auth failures, cron job stalls, and message routing errors.

Installation

To integrate OpenClaw Diagnostics into your instance, execute the following command in your terminal:

clawhub install openclaw/skills/skills/cooperun/openclaw-diagnostics

Once installed, you can ensure your knowledge base is up to date by navigating to the skill directory and running the provided update script:

cd ~/.openclaw/workspace/skills/openclaw-diagnostics && npx tsx scripts/update-knowledge-base.ts

Use Cases

This skill is indispensable in the following scenarios:

• Connectivity Troubleshooting: When channels (WhatsApp, Telegram, or Feishu) stop receiving or sending messages, this skill cross-references your current status with established diagnostic rules.
• Automation Debugging: If your scheduled tasks or cron jobs are failing to trigger, the diagnostics tool checks the execution environment and logs for common failure patterns.
• Configuration Audits: When you have migrated or modified your settings and the agent is behaving unexpectedly, the tool validates the current setup against best practices.
• Authentication Issues: Providing real-time monitoring and log analysis for auth-related tokens or session expirations.

Example Prompts

1. "diagnose: why are my group messages in the Telegram channel not responding to mentions?"
2. "troubleshoot: my cron jobs haven't been executing for the last three hours, please analyze the logs."
3. "openclaw issue: I'm seeing authentication failures, can you help me check the config settings?"

Tips & Limitations

To maximize the utility of the OpenClaw Diagnostics tool, always ensure your local knowledge base snapshot is current. While the skill is highly capable, remember that it is designed to analyze logs and configuration files within the ~/.openclaw workspace. It does not replace the need for secure API management, and while it provides diagnostic insights, physical hardware or network firewall issues outside of the OpenClaw environment may still require manual intervention. Always check the provided diagnostic scripts (get-diagnostic-info.sh and check-common-issues.sh) before attempting manual manual file edits, as they provide the safest path to resolution.