← Back to Skills Marketplace
1760
Downloads
1
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-skill-scanner
Description
Scans ClawHub skills for malicious patterns like payloads, reverse shells, data leaks, and crypto miners before and after installation.
Usage Guidance
This package is a local scanner + safe-install wrapper and appears coherent with that purpose. Before installing or using it: 1) Review whitelist.json (it contains local whitelist/blacklist decisions and will block blacklisted slugs). 2) Ensure you trust the openclaw CLI used to download skills (install-hook.sh delegates downloading to that tool). 3) Understand the scanner is regex-based and can produce false positives (it will flag common patterns like subprocess/os.system, long base64 strings, and network calls). 4) Because install-hook.sh copies files into ~/.openclaw/workspace/skills, run it in a sandbox or inspect scan reports before allowing suspicious installs. 5) If you need higher assurance, audit the remainder of scanner.py for any outbound network calls (none were found in the provided fragments) and run scans on known-good samples to calibrate false positive rates.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-skill-scanner
Version: 1.0.0
This skill bundle is a security scanner designed to detect malicious patterns in other OpenClaw skills. The `SKILL.md` clearly outlines its purpose and the types of threats it identifies (e.g., reverse shells, data exfiltration, base64 payloads), without instructing the agent to perform these actions. The `install-hook.sh` script safely downloads skills to a temporary directory using `openclaw hub install` and then invokes `scanner.py` for analysis before installation. The `scanner.py` itself contains the detection logic, including comprehensive regex patterns for various malicious activities, and explicitly avoids flagging its own code. All actions, including file system operations and subprocess calls, are consistent with the legitimate function of a security tool.
Capability Assessment
Purpose & Capability
Name/description (skill scanner) align with the provided files: scanner.py implements regex-based detection and install-hook.sh wraps a pre-install scan + safe installation. There are no unrelated required binaries or external credentials requested.
Instruction Scope
SKILL.md and install-hook.sh instruct the agent to download a skill (via the openclaw CLI), scan the downloaded files with scanner.py, then copy the skill into ~/.openclaw/workspace/skills based on the risk score. The script reads only the local whitelist.json and the downloaded skill files; it does not attempt to read unrelated system config or environment variables beyond $HOME. Behavior stays within the scanner/install scope.
Install Mechanism
No install spec (instruction-only with helper scripts). All code is shipped with the skill; there are no external archive downloads in the skill itself. The only network action is delegated to the user's openclaw CLI (used to fetch skills), which is expected for a pre-install scanner.
Credentials
The skill requires no environment variables, no credentials, and only references local paths (its own directory and the user's ~/.openclaw workspace). This is proportionate to its purpose. It does rely on the presence of python3 and the openclaw CLI to fetch remote skills (both are reasonable requirements).
Persistence & Privilege
The installer copies scanned skills into ~/.openclaw/workspace/skills — appropriate for an install hook but worth noting because it will modify the user's skill directory. always:false (no forced global inclusion) and the skill does not try to modify other skills' config. Blacklist entries in whitelist.json are enforced locally and cannot be overridden by --force.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-skill-scanner - After installation, invoke the skill by name or use
/openclaw-skill-scanner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: 26 detection patterns, pre-install hooks, blacklist/whitelist, risk scoring. Built after discovering trojanized moltbook-* skills on ClawHub.
Metadata
Frequently Asked Questions
What is OpenClaw Skill Scanner?
Scans ClawHub skills for malicious patterns like payloads, reverse shells, data leaks, and crypto miners before and after installation. It is an AI Agent Skill for Claude Code / OpenClaw, with 1760 downloads so far.
How do I install OpenClaw Skill Scanner?
Run "/install openclaw-skill-scanner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Skill Scanner free?
Yes, OpenClaw Skill Scanner is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenClaw Skill Scanner support?
OpenClaw Skill Scanner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Skill Scanner?
It is built and maintained by epwhesq (@epwhesq); the current version is v1.0.0.
More Skills