A specialized diagnostic and troubleshooting skill designed to identify and resolve configuration issues within OpenClaw environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-diagnostics
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-diagnostics using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenClaw Diagnostics?
OpenClaw Diagnostics serves as a dedicated troubleshooting expert for developers and users managing Openclaw Skills. It addresses common pain points such as channel connection failures, unresponsive group messages, and authentication errors by analyzing system logs and active configurations. This tool eliminates guesswork by cross-referencing live system data with a massive built-in knowledge base containing over 300 documentation pages, ensuring your AI agents function correctly across all integrated platforms. By automating the information-gathering process, it provides a streamlined path to maintaining a healthy Openclaw Skills ecosystem.
OpenClaw Diagnostics Use Cases
- Identifying why a bot is not responding to @ mentions or specific triggers in group chats.
- Debugging authentication failures and connection timeouts for WhatsApp, Telegram, or Feishu channels.
- Analyzing why scheduled cron jobs are failing to trigger or execute as expected.
- Performing a full health check on Openclaw Skills configuration files and Gateway service status.
- Resolving permission issues related to group policy and message routing scopes.
How OpenClaw Diagnostics Works
- Data Collection: The skill initiates the
get-diagnostic-info.shscript to capture the current state of the workspace, including logs, status, and active settings. - Automated Validation: It runs the
check-common-issues.shscript to perform rapid-fire checks against known failure patterns and common misconfigurations. - Intelligent Indexing: Based on identified symptoms, the skill searches the
knowledge-base-index.mdto locate relevant documentation slugs for deeper technical context. - Contextual Synthesis: It extracts specific technical specifications from a local JSON snapshot containing 335 indexed documentation pages.
- Actionable Feedback: It outputs a concise report detailing the root cause and the exact steps required to restore the Openclaw Skills environment to a working state.
OpenClaw Diagnostics Setup
To begin using the diagnostic tools within your Openclaw Skills workspace, ensure you have the necessary scripts available and executable:
# Navigate to the diagnostic skill directory
cd ~/.openclaw/workspace/skills/openclaw-diagnostics
# Gather system diagnostic information
./scripts/get-diagnostic-info.sh
# Run the automated common issue checker
./scripts/check-common-issues.sh
To ensure your diagnostic engine has the latest information, update the internal knowledge base:
npx tsx scripts/update-knowledge-base.ts
OpenClaw Diagnostics Data Schema & Taxonomy
The skill maintains a structured data hierarchy to provide accurate troubleshooting for Openclaw Skills:
| Component | Path | Description |
|---|---|---|
| Knowledge Base | assets/default-snapshot.json |
A compiled JSON file containing 335 documentation pages for offline reference. |
| Issue Rules | references/common-issues.md |
Defined diagnostic rules for group messages, cron jobs, and DM routing. |
| Meta Tracking | assets/update-meta.json |
Tracks documentation versioning, sitemap lastmod dates, and update history. |
| Diagnostic Scripts | scripts/ |
Shell and TypeScript files for system analysis, status reporting, and KB maintenance. |
OpenClaw Diagnostics Advanced Features
- Offline Documentation Support: Access a massive repository of 335 documentation pages locally without requiring an active internet connection for retrieval.
- Smart Update Mechanism: Use the built-in update script to sync with the latest OpenClaw documentation based on sitemap versioning.
- Lightweight Execution: Documentation lookup and basic diagnostics do not require LLM calls, saving API tokens and increasing speed.
- Protocol-Specific Logic: Specialized diagnostic rules for different messaging protocols including WhatsApp, Telegram, and Feishu.
- Configuration Validation: Detects subtle errors in complex settings like ackReactionScope and groupPolicy within your Openclaw Skills setup.
SKILL.md
Loading
Related Openclaw Skills
reMarkable Integration
A powerful integration that syncs handwritten content from your reMarkable tablet to AI workflows for text extraction and sketch refinement.
reMarkable Tablet Integration
A bidirectional synchronization tool that connects reMarkable tablets to AI agents for automated note processing and sketch enhancement.
Canva Connect
Manage Canva designs, assets, and folders programmatically via the Connect API integration.
Pixel World Interaction
A shared 256x256 pixel environment where agents study emergent social dynamics through scarce, high-impact actions.
Git Workspace Backup
A specialized automation skill for scheduling directory backups to remote Git repositories using cron or launchd.
Email Reader
A powerful skill that allows AI agents to read, search, and manage Gmail messages directly via the gog CLI.
Featured*
