Crabukit

Crabukit 是用于扫描 OpenClaw Skill 的静态安全分析工具，检查 SKILL.md 与脚本中的硬编码密钥、代码注入、危险 Shell 模式及危险权限，输出 0-100 风险评分与等级；可选结合 Clawdex 数据库识别已知恶意 Skill，并支持安装前扫描与 CI 失败阈值。

tnbradley

热度 70.18

最近更新 2026-05-11 17:26:37

分类：安全依赖：代码执行 / 读写文件 / 第三方 API应用场景：代码审查 / DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add crabukit

Metadata

name: crabukit
description: Security scanner for OpenClaw skills with Clawdex integration. Analyzes SKILL.md and scripts for dangerous permissions, hardcoded secrets, shell injection vulnerabilities, and malicious code patterns. Automatically uses Clawdex database if installed for known-malicious skill detection. Use when (1) installing a skill from an untrusted source, (2) developing a skill before publishing, (3) auditing installed skills, or (4) running CI/CD security checks.
metadata: {"clawdbot":{"emoji":"🔒","category":"security","files":["pyproject.toml","crabukit/**/*.py","scripts/**/*","tests/**/*","README.md","LICENSE","CHANGELOG.md"],"install":[{"id":"pip","kind":"pip","package":".","bins":["crabukit"],"label":"Install crabukit from source"}]}}

🔒 Crabukit

Security scanner for OpenClaw skills. Prevents installation of malicious or vulnerable skills by static analysis. Integrates with Clawdex for comprehensive protection.

Quick Start

# Safely install a skill (scans before installing)
crabukit install youtube-summarize

# Scan a local skill before installing
crabukit scan ./suspicious-skill/

# Scan an installed skill
crabukit scan /opt/homebrew/lib/node_modules/clawdbot/skills/unknown-skill

# CI mode - fail on high severity or above
crabukit scan ./my-skill --fail-on=high

# List all detection rules
crabukit list-rules

🔌 Clawdex Integration

Crabukit automatically integrates with Clawdex if installed:

# Install Clawdex for database-based protection
clawdhub install clawdex

# Now crabukit will:
# 1. Check Clawdex database (known 824+ malicious skills)
# 2. Run behavior analysis (zero-day detection)
# → Defense in depth!

Layered Protection:

Clawdex: Database of known-bad skills (fast lookup)
Crabukit: Behavior analysis for zero-days (static analysis)

What It Detects

Category	Issues
External DB	Known malicious skills (via Clawdex)
Secrets	Hardcoded API keys, private keys, passwords
Code Injection	`eval()`, `exec()`, `subprocess(shell=True)`
Shell Risks	`curl \| bash`, `rm -rf`, unquoted variables
Permissions	Dangerous tool requests without safety guidance
Metadata	Suspicious patterns in SKILL.md descriptions

Risk Scoring

Crabukit assigns a score (0-100) based on findings:

Score	Level	Action
0	Clean	Safe to install
1-9	Low	Minor issues
10-24	Medium	Review findings
25-49	High	Careful review required
50+	Critical	Do not install

Exit Codes

0 - Scan completed, no findings at or above --fail-on threshold
1 - Findings at or above threshold detected

CI/CD Integration

# .github/workflows/security.yml
- name: Scan skill
  run: |
    pip install crabukit
    crabukit scan ./my-skill --fail-on=medium

Installation

# Via ClawdHub (when published)
clawdhub install crabukit

# Or via pip
pip install crabukit

# Or from source
git clone https://github.com/tnbradley/crabukit.git
cd crabukit
pip install -e .