← Back to Skills Marketplace
400
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-diagnostics
Description
Diagnoses and troubleshoots OpenClaw config, channel, group message, cron job, and authentication issues using logs and built-in knowledge base.
Usage Guidance
This skill appears to be a legitimate OpenClaw diagnostics tool, but it will read and print files from $HOME/.openclaw (including openclaw.json) and may call your local openclaw CLI; those files can contain tokens or secrets. Before installing or running: 1) Inspect ~/.openclaw/openclaw.json for sensitive fields and consider redacting secrets or running the scripts in a sandbox; 2) Review scripts/get-diagnostic-info.sh and scripts/check-common-issues.sh (already included) and the entire update-knowledge-base.ts for any unexpected endpoints or embedded data; 3) Because the SKILL.md/meta do not declare the config path or required binary, assume it will access local OpenClaw credentials and logs — if you cannot risk disclosure, do not enable autonomous invocation and run the scripts manually instead; 4) The pre-scan flags (prompt-override, base64, unicode control chars) may be false positives but warrant a manual check of SKILL.md and assets for obfuscated content. If the publisher/source is unknown or untrusted, prefer to run diagnostics locally rather than grant the skill ongoing or autonomous privileges.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-diagnostics
Version: 1.0.0
The skill bundle is designed for OpenClaw diagnostics but includes scripts (`get-diagnostic-info.sh` and `check-common-issues.sh`) that read the `~/.openclaw/openclaw.json` configuration file, which typically contains sensitive API keys and channel credentials. Specifically, `get-diagnostic-info.sh` outputs the entire raw configuration to the agent's context without any redaction, creating a significant risk of credential exposure. While these actions are consistent with the stated diagnostic purpose, the lack of secret filtering and the inclusion of a network-enabled update script (`update-knowledge-base.ts`) that fetches remote content from `docs.openclaw.ai` represent a high-risk profile.
Capability Assessment
Purpose & Capability
The skill's name/description match what the scripts do (gather local OpenClaw config, status, and logs and consult a bundled docs snapshot). However the package does not declare that it expects the OpenClaw CLI or that it will read $HOME/.openclaw/openclaw.json, which is inconsistent with its actual behavior.
Instruction Scope
Runtime instructions and included scripts explicitly read the user's OpenClaw config and logs (~$HOME/.openclaw/openclaw.json and calling `openclaw logs`/`openclaw status`). That is appropriate for diagnostics, but SKILL.md gives the skill broad discretion to load and print those files; this can expose secrets. The SKILL.md also instructs running update-knowledge-base (network fetch) which will contact docs.openclaw.ai to download many pages.
Install Mechanism
No install spec (instruction-only with shipped scripts and assets). The update script fetches docs from a single official-looking domain (docs.openclaw.ai). No ad-hoc binary downloads or extract-from-unknown-URLs were found.
Credentials
The skill requests no env vars in metadata but its scripts access the user's home config and may print auth-related fields from openclaw.json or from `openclaw logs` output. This access is plausible for a diagnostics tool but the lack of declared config paths or a required-binary entry is a mismatch and increases risk of accidental secret exposure.
Persistence & Privilege
always is false and the skill writes only to its own assets directory when updating the knowledge base. It does not appear to modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-diagnostics - After installation, invoke the skill by name or use
/openclaw-diagnostics - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - Offline OpenClaw diagnostics with built-in 335-page knowledge base, zero LLM dependency, lightweight shell scripts
Metadata
Frequently Asked Questions
What is OpenClaw Diagnostics?
Diagnoses and troubleshoots OpenClaw config, channel, group message, cron job, and authentication issues using logs and built-in knowledge base. It is an AI Agent Skill for Claude Code / OpenClaw, with 400 downloads so far.
How do I install OpenClaw Diagnostics?
Run "/install openclaw-diagnostics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Diagnostics free?
Yes, OpenClaw Diagnostics is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenClaw Diagnostics support?
OpenClaw Diagnostics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Diagnostics?
It is built and maintained by Cooperun (@cooperun); the current version is v1.0.0.
More Skills