Clawsec clawsec-clawhub-checker
ClawHub reputation checker for clawsec-suite. Adds a standalone reputation gate before guarded skill installation.
install
source · Clone the upstream repo
git clone https://github.com/prompt-security/clawsec
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/prompt-security/clawsec "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/clawsec-clawhub-checker" ~/.claude/skills/prompt-security-clawsec-clawsec-clawhub-checker && rm -rf "$T"
manifest:
skills/clawsec-clawhub-checker/SKILL.mdsource content
ClawSec ClawHub Checker
Adds a reputation gate on top of the
clawsec-suite guarded installer.
Operational Notes
- Required runtime:
,node
,clawhubopenclaw - Depends on: installed
clawsec-suite - Side effects: none on other skills; this package does not rewrite installed suite files
- Advisory-hook wiring is optional and manual in this release
- Network behavior: reputation checks call ClawHub inspect/search endpoints
- Trust model: scores are heuristic and confirmation-gated
What It Does
- Reads skill metadata from ClawHub (
)inspect --json - Evaluates scanner status (including VirusTotal summary when present)
- Applies additional reputation heuristics (age, updates, author history, downloads)
- Requires explicit
when score is below threshold--confirm-reputation
Installation
Install after
clawsec-suite:
npx clawhub@latest install clawsec-suite npx clawhub@latest install clawsec-clawhub-checker
Optional preflight check (validates local paths and prints recommended command):
node ~/.openclaw/skills/clawsec-clawhub-checker/scripts/setup_reputation_hook.mjs
Usage
Run the enhanced installer directly from this skill:
node ~/.openclaw/skills/clawsec-clawhub-checker/scripts/enhanced_guarded_install.mjs \ --skill some-skill \ --version 1.0.0
If a skill is below threshold, rerun only with explicit approval:
node ~/.openclaw/skills/clawsec-clawhub-checker/scripts/enhanced_guarded_install.mjs \ --skill some-skill \ --version 1.0.0 \ --confirm-reputation
Optional Advisory-Hook Wiring (Manual)
This release does not auto-patch
clawsec-suite hook files.If you rely on advisory alerts that include
reputationWarning / reputationWarnings, wire the checker module manually:
- Source module:
~/.openclaw/skills/clawsec-clawhub-checker/hooks/clawsec-advisory-guardian/lib/reputation.mjs - Target hook file:
~/.openclaw/skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts
Treat that wiring as a deliberate local customization and review it before enabling.
Exit Codes
safe to install0
advisory confirmation required (from clawsec-suite)42
reputation confirmation required43
error1
Configuration
Environment variables:
- Minimum score (0-100, default: 70)CLAWHUB_REPUTATION_THRESHOLD
Safety Notes
- This is defense-in-depth, not a replacement for advisory matching
- Scanner outputs can produce false positives and false negatives
- Always review skill code before overriding warnings
Development
Key files:
scripts/enhanced_guarded_install.mjsscripts/check_clawhub_reputation.mjsscripts/setup_reputation_hook.mjshooks/clawsec-advisory-guardian/lib/reputation.mjs
License
GNU AGPL v3.0 or later - Part of the ClawSec security suite