← Back to Skills Marketplace
jchandler187

ClawSec

by jchandler187 · GitHub ↗ · v2.3.4 · MIT-0
cross-platform ⚠ pending
65
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install clawsec-verify
Description
Scan ClawHub skills for security vulnerabilities before installing — 9 threat intel sources, 7 autonomous checks, instant slug scan.
README (SKILL.md)

⚡ ClawSec

Security verification for ClawHub skills. Scan any skill — by local path or ClawHub slug — against 9 continuously-updated threat intelligence sources using 7 autonomous security checks.

What it does

ClawSec scans a skill directory for security issues before you install it. It checks dependencies against known vulnerability databases, scans for hardcoded secrets, detects indicators of compromise, and looks for prompt injection vectors — all without sending your data anywhere.

One command to scan any ClawHub skill:

clawsec scan weather-forecast

That downloads the skill from ClawHub, scans it, shows results, and cleans up. No manual steps.

Or scan a local skill directory:

clawsec scan ./my-skill

When to use this skill

Use ClawSec when you are about to install a skill from ClawHub and want to verify it is safe. Also use it when developing your own skills — run a scan before publishing to catch issues early.

Parameters

  • target (required) — A local directory path or a ClawHub skill slug (e.g. weather-forecast). If a slug is provided, the skill is downloaded temporarily, scanned, and removed.
  • checks (optional) — Comma-separated list of checks to run: dep-scan, static-analysis, secret-scan, yara-scan, ioc-match, behavioral, prompt-inject. Default: all 7.
  • json (optional) — Output results as JSON for programmatic use.

Return value

ClawSec outputs a structured report with:

  • verdictpass, warn, or fail
  • findings — Array of issues found, each with severity (critical, high, medium), description, and file location
  • report_id — Short ID for later retrieval via clawsec report \x3Cid>

Exit codes: 0 = pass, 1 = warn, 2 = fail

Checks

Check What it does
dep-scan Cross-references dependencies against CISA KEV and OSV databases
static-analysis Runs Semgrep rules for security anti-patterns
secret-scan Scans for hardcoded API keys, tokens, and credentials using Gitleaks
yara-scan Matches files against YARA rules for malware patterns
ioc-match Matches IPs, domains, URLs, and file hashes against ThreatFox, URLhaus, MalwareBazaar, and Feodo trackers
behavioral Detects suspicious patterns: eval usage, shell injection, data exfiltration vectors, DNS tunneling
prompt-inject Detects prompt injection and instruction-hiding patterns in SKILL.md

Threat intel sources (9, continuously synced)

CISA KEV · OSV (npm + PyPI) · EPSS · MalwareBazaar · URLhaus · ThreatFox · Feodo Tracker · YARA Rules · Semgrep Rules

Run clawsec sync to refresh the intel cache.

Security & Privacy

  • No data leaves your machine. All scanning happens locally. No telemetry, no phone-home, no analytics.
  • Downloaded skills are sandboxed. When scanning by slug, the skill is downloaded to a 0700-permission temp directory, all files have execute permissions stripped before scanning, and npm postinstall scripts are suppressed. The skill is deleted after scanning.
  • Credentials stay local. ClawSec reads environment variables for configuration but never transmits them.

External endpoints

ClawSec downloads threat intel feeds from these public sources during clawsec sync:

Source URL Data sent
CISA KEV https://www.cisa.gov/sites/default/files/feeds/ None (GET only)
OSV https://api.osv.dev/v1/query Package name + version for dependency lookup
EPSS https://epss.cyentia.com/api/v1/ None (GET only)
MalwareBazaar https://mb-api.abuse.ch/api/v1/ None (POST for hash lookup)
URLhaus https://urlhaus-api.abuse.ch/v1/urls/ None (GET only)
ThreatFox https://threatfox-api.abuse.ch/api/v1/ None (POST for IOC lookup)
Feodo Tracker https://feodotracker.abuse.ch/downloads/ None (GET only)
YARA Rules https://github.com/Yara-Rules/rules.git None (git clone)
Semgrep Rules https://github.com/returntocorp/semgrep-rules.git None (git clone)

During clawsec scan, no network requests are made. All intel is local.

Local files read

  • ~/.clawsec/intel/ — Threat intel cache
  • Skill directory passed as scan target

Local files written

  • ~/.clawsec/intel/ — Synced threat intel data
  • ~/.clawsec/reports/ — Scan reports (JSON)
  • ~/.clawsec/venv/ — Python virtual environment for scan checks

Trust statement

By using ClawSec, you trust the threat intel sources listed above to provide accurate vulnerability and IOC data. No skill code or scan targets are transmitted to any external service. Install it only if you trust the Low Watt Labs project and the listed intel sources.

Install

npm install -g @lowwattlabs/clawsec

First run automatically creates a Python venv and syncs threat intel. After that, clawsec scan works with zero configuration.

Docker

docker build -t lowwattlabs/clawsec .
docker run -p 3100:3100 lowwattlabs/clawsec

Pricing

Free. No paid tier, no API keys, no limits. If you find it useful, buy me a coffee.

License

MIT-0 — same as all ClawHub skills.

How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawsec-verify
  3. After installation, invoke the skill by name or use /clawsec-verify
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.3.4
No changes in this release. - Version bumped to 2.3.4 with no modifications to the code or documentation.
v2.3.3
- Improved SKILL.md with detailed feature, privacy, and usage documentation - Clarified security model: all scanning is local, no telemetry, skills are sandboxed - Listed exact environment variables, dependencies, and return values - Documented all 7 security checks and 9 threat intelligence sources - Added guidance for installation, Docker, and syncing threat intel - Included up-to-date trust, privacy, and endpoint statements for transparency
Metadata
Slug clawsec-verify
Version 2.3.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is ClawSec?

Scan ClawHub skills for security vulnerabilities before installing — 9 threat intel sources, 7 autonomous checks, instant slug scan. It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.

How do I install ClawSec?

Run "/install clawsec-verify" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ClawSec free?

Yes, ClawSec is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ClawSec support?

ClawSec is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ClawSec?

It is built and maintained by jchandler187 (@jchandler187); the current version is v2.3.4.

💬 Comments