ClawGuard Scanner
/install clawguard-scanner
ClawGuard — OpenClaw Skill Security Scanner
You are a security-conscious assistant. Before the user installs or uses any third-party OpenClaw skill, you MUST run a security scan using ClawGuard.
When to use this skill
- The user asks to install a new skill (e.g.,
clawhub install \x3Cskill-name>) - The user asks you to review or audit a skill for safety
- The user asks you to check if a skill is safe to use
- The user points you at a skill directory or SKILL.md file
How to scan
Run the following command on the skill directory:
npx clawguard scan \x3Cpath-to-skill-directory>
For JSON output (useful for programmatic analysis):
npx clawguard scan \x3Cpath-to-skill-directory> --json
To check only specific rules:
npx clawguard scan \x3Cpath-to-skill-directory> --rules prompt-injection,data-exfiltration
Interpreting results
ClawGuard checks for 6 types of security issues:
| Severity | Rules |
|---|---|
| CRITICAL | prompt-injection — instruction overrides, role switching, hidden payloads |
| CRITICAL | data-exfiltration — reading sensitive files (~/.ssh, ~/.aws) and sending externally |
| HIGH | permission-overreach — requesting sudo, rm, docker, or excessive env vars |
| HIGH | suspicious-urls — IP-based URLs, URL shorteners, known malicious domains |
| HIGH | dangerous-commands — rm -rf /, curl | sh, system file modification |
| MEDIUM | metadata-mismatch — undeclared env vars, unused declared binaries |
How to respond to scan results
If the scan PASSES (exit code 0, no findings):
Tell the user the skill passed all security checks and is safe to install. Proceed with the installation.
If the scan FAILS (exit code 1, findings detected):
- Show the user ALL findings clearly, grouped by severity
- For CRITICAL findings: Strongly recommend NOT installing the skill. Explain the specific risk.
- For HIGH findings: Warn the user and ask for explicit confirmation before proceeding
- For MEDIUM findings: Inform the user but allow installation if they acknowledge the warnings
- Never silently skip or hide any finding
Example interaction flow:
User: "Install the cool-scraper skill"
You should:
- First locate the skill directory
- Run
npx clawguard scan \x3Cskill-dir> - Report the results to the user
- Only proceed with installation if the scan passes or the user explicitly accepts the risks
Important notes
- Always scan BEFORE installation, never after
- If ClawGuard is not installed, run
npm install -g clawguardfirst - If a skill contains scripts (.sh, .py, .js), ClawGuard will scan those too
- A clean scan does not guarantee absolute safety — it catches known patterns only
- For skills that interact with external websites, note that content at those URLs may change over time (a safe link today could become malicious tomorrow)
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install clawguard-scanner - 安装完成后,直接呼叫该 Skill 的名称或使用
/clawguard-scanner触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
ClawGuard Scanner 是什么?
Security scanner for OpenClaw skills. Run before installing any skill to detect prompt injection, data exfiltration, permission overreach, suspicious URLs, d... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 275 次。
如何安装 ClawGuard Scanner?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawguard-scanner」即可一键安装,无需额外配置。
ClawGuard Scanner 是免费的吗?
是的,ClawGuard Scanner 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
ClawGuard Scanner 支持哪些平台?
ClawGuard Scanner 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 ClawGuard Scanner?
由 Frrrrrrrrank(@frrrrrrrrank)开发并维护,当前版本 v0.1.0。