How prompt-security/clawsec works
ClawSec combines a web catalog and signed advisory channel with installable security skills for AI-agent runtimes. In the primary OpenClaw flow, the advisory hook loads and verifies feed material, discovers installed skills, matches advisories, then reports or gates risky actions; operators explicitly approve persistent hook setup and risky overrides. Separate packages add integrity, attestation, posture, scanner, and audit capabilities across supported platforms. The graph includes documented capabilities whose implementations were not sampled; those links use README evidence. Source-level links reflect shown imports or calls, not a complete inspection of unsampled modules.
Main entry points: App.tsx Web application · handler.ts Advisory hook · ipc-handlers.ts NanoClaw host services · feed.mjs Feed verification
Components 26
Web catalog
- Web application
App.tsx - Overview
pages/Home.tsx - Skill catalog
pages/SkillsCatalog.tsx - Skill detail
pages/SkillDetail.tsx - Feed browser
pages/FeedSetup.tsx - Advisory detail
pages/AdvisoryDetail.tsx - Wiki browser
pages/WikiBrowser.tsx - Shared layout
components/Layout.tsx
Advisory intelligence
- Signed feed
advisories/feed.json - GHSA feed pipeline
scripts/ghsa-without-cve-feed.mjs
OpenClaw suite
- Advisory hook
skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts - Feed verification
skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs - Skill matching
skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/matching.ts - Guarded installs
skills/clawsec-suite/scripts/guarded_skill_install.mjs
Platform protections
- Integrity monitoring
skills/clawsec-nanoclaw/guardian/integrity-monitor.ts - NanoClaw host services
skills/clawsec-nanoclaw/host-services/ipc-handlers.ts - Signature verification
skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts - Signature library
skills/clawsec-nanoclaw/lib/signatures.ts - Hermes feed verification
skills/hermes-attestation-guardian/lib/feed.mjs - Hermes attestations
skills/hermes-attestation-guardian/lib/attestation.mjs - Picoclaw drift checks
skills/picoclaw-security-guardian/lib/drift.mjs - Scanner hook
skills/clawsec-scanner/hooks/clawsec-scanner-hook/handler.ts - CVE database queries
skills/clawsec-scanner/scripts/query_cve_databases.mjs - Audit and reporting
skills/openclaw-audit-watchdog/scripts/render_report.mjs
Other components
- Operator
- Feed hosting
Connections 25
- Operator → Web application: browses
README.md - Web application → Shared layout: wraps routes
App.tsx - Web application → Overview: routes to
App.tsx - Web application → Skill catalog: routes to
App.tsx - Web application → Skill detail: routes to
App.tsx - Web application → Feed browser: routes to
App.tsx - Web application → Advisory detail: routes to
App.tsx - Web application → Wiki browser: routes to
App.tsx - Operator → Advisory hook: enables hook
README.md - Advisory hook → Feed verification: loads and verifies
skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts - Advisory hook → Skill matching: matches skills
skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts - Feed verification → Feed hosting: fetches feed
README.md - Feed hosting → Signed feed: serves signed feed
README.md - GHSA feed pipeline → Signed feed: produces advisories
- Advisory hook → Guarded installs: gates risky installs
README.md - NanoClaw host services → Integrity monitoring: handles integrity IPC
- NanoClaw host services → Signature verification: dispatches services
skills/clawsec-nanoclaw/host-services/ipc-handlers.ts - Signature verification → Signature library: verifies signatures
skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts - Hermes feed verification → Hermes attestations: provides feed logic
skills/hermes-attestation-guardian/lib/attestation.mjs - Scanner hook → CVE database queries: queries vulnerabilities
- Operator → Integrity monitoring: monitors drift
README.md - Operator → Hermes feed verification: checks advisories
README.md - Operator → Picoclaw drift checks: checks posture
README.md - Operator → Scanner hook: runs scans
- Operator → Audit and reporting: requests audits
README.md