/install clawsec-clawhub-checker
ClawSec ClawHub Checker
Adds a reputation gate on top of the clawsec-suite guarded installer.
Operational Notes
- Required runtime:
node,clawhub,openclaw - 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
--confirm-reputationwhen score is below threshold
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
0safe to install42advisory confirmation required (from clawsec-suite)43reputation confirmation required1error
Configuration
Environment variables:
CLAWHUB_REPUTATION_THRESHOLD- Minimum score (0-100, default: 70)
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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clawsec-clawhub-checker - After installation, invoke the skill by name or use
/clawsec-clawhub-checker - Provide required inputs per the skill's parameter spec and get structured output
What is clawsec-clawhub-checker?
ClawHub reputation checker for clawsec-suite. Adds a standalone reputation gate before guarded skill installation. It is an AI Agent Skill for Claude Code / OpenClaw, with 389 downloads so far.
How do I install clawsec-clawhub-checker?
Run "/install clawsec-clawhub-checker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is clawsec-clawhub-checker free?
Yes, clawsec-clawhub-checker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does clawsec-clawhub-checker support?
clawsec-clawhub-checker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created clawsec-clawhub-checker?
It is built and maintained by davida-ps (@davida-ps); the current version is v0.0.3.