# prompt-security/clawsec architecture

> Architecture diagram of the GitHub repository prompt-security/clawsec, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prompt-security/clawsec
- Repository: https://github.com/prompt-security/clawsec

## Overview

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`](https://github.com/prompt-security/clawsec/blob/main/App.tsx) (Web application), [`skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts) (Advisory hook), [`skills/clawsec-nanoclaw/host-services/ipc-handlers.ts`](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/host-services/ipc-handlers.ts) (NanoClaw host services), [`skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs`](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs) (Feed verification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web catalog"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_home["Overview<br/>[Home.tsx]"]
  node_catalog["Skill catalog<br/>[SkillsCatalog.tsx]"]
  node_skilldetail["Skill detail<br/>[SkillDetail.tsx]"]
  node_feedpage["Feed browser<br/>[FeedSetup.tsx]"]
  node_advisorydetail["Advisory detail<br/>[AdvisoryDetail.tsx]"]
  node_wikibrowser["Wiki browser<br/>[WikiBrowser.tsx]"]
  node_layout["Shared layout<br/>[Layout.tsx]"]
end

subgraph group_intel["Advisory intelligence"]
  node_advisoryfeed["Signed feed<br/>[feed.json]"]
  node_feedpublisher["GHSA feed pipeline"]
end

subgraph group_openclaw["OpenClaw suite"]
  node_suitehook["Advisory hook<br/>[handler.ts]"]
  node_feedverify["Feed verification<br/>[feed.mjs]"]
  node_skillmatch["Skill matching<br/>[matching.ts]"]
  node_guardedinstall["Guarded installs"]
end

subgraph group_platforms["Platform protections"]
  node_integrity["Integrity monitoring"]
  node_nanohost["NanoClaw host services<br/>[ipc-handlers.ts]"]
  node_signature["Signature verification"]
  node_signaturelib["Signature library<br/>[signatures.ts]"]
  node_hermesfeed["Hermes feed verification<br/>[feed.mjs]"]
  node_attestation["Hermes attestations<br/>[attestation.mjs]"]
  node_picodrift["Picoclaw drift checks<br/>[drift.mjs]"]
  node_scanner["Scanner hook<br/>[handler.ts]"]
  node_cvedb["CVE database queries"]
  node_audit["Audit and reporting<br/>[render_report.mjs]"]
end

node_operator(("Operator"))
node_externalfeed(("Feed hosting"))

node_operator -->|"browses"| node_webapp
node_webapp -->|"wraps routes"| node_layout
node_webapp -->|"routes to"| node_home
node_webapp -->|"routes to"| node_catalog
node_webapp -->|"routes to"| node_skilldetail
node_webapp -->|"routes to"| node_feedpage
node_webapp -->|"routes to"| node_advisorydetail
node_webapp -->|"routes to"| node_wikibrowser
node_operator -->|"enables hook"| node_suitehook
node_suitehook -->|"loads and verifies"| node_feedverify
node_suitehook -->|"matches skills"| node_skillmatch
node_feedverify -->|"fetches feed"| node_externalfeed
node_externalfeed -->|"serves signed feed"| node_advisoryfeed
node_feedpublisher -.->|"produces advisories"| node_advisoryfeed
node_suitehook -.->|"gates risky installs"| node_guardedinstall
node_nanohost -->|"handles integrity IPC"| node_integrity
node_nanohost -.->|"dispatches services"| node_signature
node_signature -->|"verifies signatures"| node_signaturelib
node_hermesfeed -->|"provides feed logic"| node_attestation
node_scanner -.->|"queries vulnerabilities"| node_cvedb
node_operator -->|"monitors drift"| node_integrity
node_operator -->|"checks advisories"| node_hermesfeed
node_operator -->|"checks posture"| node_picodrift
node_operator -.->|"runs scans"| node_scanner
node_operator -->|"requests audits"| node_audit

click node_webapp "https://github.com/prompt-security/clawsec/blob/main/App.tsx"
click node_home "https://github.com/prompt-security/clawsec/blob/main/pages/Home.tsx"
click node_catalog "https://github.com/prompt-security/clawsec/blob/main/pages/SkillsCatalog.tsx"
click node_skilldetail "https://github.com/prompt-security/clawsec/blob/main/pages/SkillDetail.tsx"
click node_feedpage "https://github.com/prompt-security/clawsec/blob/main/pages/FeedSetup.tsx"
click node_advisorydetail "https://github.com/prompt-security/clawsec/blob/main/pages/AdvisoryDetail.tsx"
click node_wikibrowser "https://github.com/prompt-security/clawsec/blob/main/pages/WikiBrowser.tsx"
click node_layout "https://github.com/prompt-security/clawsec/blob/main/components/Layout.tsx"
click node_advisoryfeed "https://github.com/prompt-security/clawsec/blob/main/advisories/feed.json"
click node_feedpublisher "https://github.com/prompt-security/clawsec/blob/main/scripts/ghsa-without-cve-feed.mjs"
click node_suitehook "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts"
click node_feedverify "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs"
click node_skillmatch "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/matching.ts"
click node_guardedinstall "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/scripts/guarded_skill_install.mjs"
click node_integrity "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/guardian/integrity-monitor.ts"
click node_nanohost "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/host-services/ipc-handlers.ts"
click node_signature "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts"
click node_signaturelib "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/lib/signatures.ts"
click node_hermesfeed "https://github.com/prompt-security/clawsec/blob/main/skills/hermes-attestation-guardian/lib/feed.mjs"
click node_attestation "https://github.com/prompt-security/clawsec/blob/main/skills/hermes-attestation-guardian/lib/attestation.mjs"
click node_picodrift "https://github.com/prompt-security/clawsec/blob/main/skills/picoclaw-security-guardian/lib/drift.mjs"
click node_scanner "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-scanner/hooks/clawsec-scanner-hook/handler.ts"
click node_cvedb "https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-scanner/scripts/query_cve_databases.mjs"
click node_audit "https://github.com/prompt-security/clawsec/blob/main/skills/openclaw-audit-watchdog/scripts/render_report.mjs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_home,node_catalog,node_skilldetail,node_feedpage,node_advisorydetail,node_wikibrowser,node_layout toneBlue
class node_advisoryfeed,node_feedpublisher toneAmber
class node_suitehook,node_feedverify,node_skillmatch,node_guardedinstall toneMint
class node_integrity,node_nanohost,node_signature,node_signaturelib,node_hermesfeed,node_attestation,node_picodrift,node_scanner,node_cvedb,node_audit toneRose
class node_operator,node_externalfeed toneIndigo
```

## Components

### Web catalog

- [Web application](https://github.com/prompt-security/clawsec/blob/main/App.tsx): `App.tsx`
- [Overview](https://github.com/prompt-security/clawsec/blob/main/pages/Home.tsx): `pages/Home.tsx`
- [Skill catalog](https://github.com/prompt-security/clawsec/blob/main/pages/SkillsCatalog.tsx): `pages/SkillsCatalog.tsx`
- [Skill detail](https://github.com/prompt-security/clawsec/blob/main/pages/SkillDetail.tsx): `pages/SkillDetail.tsx`
- [Feed browser](https://github.com/prompt-security/clawsec/blob/main/pages/FeedSetup.tsx): `pages/FeedSetup.tsx`
- [Advisory detail](https://github.com/prompt-security/clawsec/blob/main/pages/AdvisoryDetail.tsx): `pages/AdvisoryDetail.tsx`
- [Wiki browser](https://github.com/prompt-security/clawsec/blob/main/pages/WikiBrowser.tsx): `pages/WikiBrowser.tsx`
- [Shared layout](https://github.com/prompt-security/clawsec/blob/main/components/Layout.tsx): `components/Layout.tsx`

### Advisory intelligence

- [Signed feed](https://github.com/prompt-security/clawsec/blob/main/advisories/feed.json): `advisories/feed.json`
- [GHSA feed pipeline](https://github.com/prompt-security/clawsec/blob/main/scripts/ghsa-without-cve-feed.mjs): `scripts/ghsa-without-cve-feed.mjs`

### OpenClaw suite

- [Advisory hook](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts): `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`
- [Feed verification](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs): `skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/feed.mjs`
- [Skill matching](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/matching.ts): `skills/clawsec-suite/hooks/clawsec-advisory-guardian/lib/matching.ts`
- [Guarded installs](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-suite/scripts/guarded_skill_install.mjs): `skills/clawsec-suite/scripts/guarded_skill_install.mjs`

### Platform protections

- [Integrity monitoring](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/guardian/integrity-monitor.ts): `skills/clawsec-nanoclaw/guardian/integrity-monitor.ts`
- [NanoClaw host services](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/host-services/ipc-handlers.ts): `skills/clawsec-nanoclaw/host-services/ipc-handlers.ts`
- [Signature verification](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts): `skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts`
- [Signature library](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-nanoclaw/lib/signatures.ts): `skills/clawsec-nanoclaw/lib/signatures.ts`
- [Hermes feed verification](https://github.com/prompt-security/clawsec/blob/main/skills/hermes-attestation-guardian/lib/feed.mjs): `skills/hermes-attestation-guardian/lib/feed.mjs`
- [Hermes attestations](https://github.com/prompt-security/clawsec/blob/main/skills/hermes-attestation-guardian/lib/attestation.mjs): `skills/hermes-attestation-guardian/lib/attestation.mjs`
- [Picoclaw drift checks](https://github.com/prompt-security/clawsec/blob/main/skills/picoclaw-security-guardian/lib/drift.mjs): `skills/picoclaw-security-guardian/lib/drift.mjs`
- [Scanner hook](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-scanner/hooks/clawsec-scanner-hook/handler.ts): `skills/clawsec-scanner/hooks/clawsec-scanner-hook/handler.ts`
- [CVE database queries](https://github.com/prompt-security/clawsec/blob/main/skills/clawsec-scanner/scripts/query_cve_databases.mjs): `skills/clawsec-scanner/scripts/query_cve_databases.mjs`
- [Audit and reporting](https://github.com/prompt-security/clawsec/blob/main/skills/openclaw-audit-watchdog/scripts/render_report.mjs): `skills/openclaw-audit-watchdog/scripts/render_report.mjs`

### Other components

- **Operator**
- **Feed hosting**

## Connections

- Operator → Web application: browses (evidence: `README.md`)
- Web application → Shared layout: wraps routes (evidence: `App.tsx`)
- Web application → Overview: routes to (evidence: `App.tsx`)
- Web application → Skill catalog: routes to (evidence: `App.tsx`)
- Web application → Skill detail: routes to (evidence: `App.tsx`)
- Web application → Feed browser: routes to (evidence: `App.tsx`)
- Web application → Advisory detail: routes to (evidence: `App.tsx`)
- Web application → Wiki browser: routes to (evidence: `App.tsx`)
- Operator → Advisory hook: enables hook (evidence: `README.md`)
- Advisory hook → Feed verification: loads and verifies (evidence: `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`)
- Advisory hook → Skill matching: matches skills (evidence: `skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts`)
- Feed verification → Feed hosting: fetches feed (evidence: `README.md`)
- Feed hosting → Signed feed: serves signed feed (evidence: `README.md`)
- GHSA feed pipeline → Signed feed: produces advisories
- Advisory hook → Guarded installs: gates risky installs (evidence: `README.md`)
- NanoClaw host services → Integrity monitoring: handles integrity IPC
- NanoClaw host services → Signature verification: dispatches services (evidence: `skills/clawsec-nanoclaw/host-services/ipc-handlers.ts`)
- Signature verification → Signature library: verifies signatures (evidence: `skills/clawsec-nanoclaw/host-services/skill-signature-handler.ts`)
- Hermes feed verification → Hermes attestations: provides feed logic (evidence: `skills/hermes-attestation-guardian/lib/attestation.mjs`)
- Scanner hook → CVE database queries: queries vulnerabilities
- Operator → Integrity monitoring: monitors drift (evidence: `README.md`)
- Operator → Hermes feed verification: checks advisories (evidence: `README.md`)
- Operator → Picoclaw drift checks: checks posture (evidence: `README.md`)
- Operator → Scanner hook: runs scans
- Operator → Audit and reporting: requests audits (evidence: `README.md`)
