How cisco-ai-defense/defenseclaw works
DefenseClaw is a security-governance layer for OpenClaw and agentic AI runtimes. The principal operator workflow starts at the Python CLI, dispatches a command to configure or inspect the deployment, and uses the gateway and policy/scanning capabilities to govern runtime activity and produce audit or observability evidence. The README also identifies connector hooks, exporters, and the operator TUI as product capabilities. Several internal links are shown as unverified because their call paths were not sampled; the graph does not imply that adjacent subsystems call one another.
Main entry points: commands CLI commands · otel_ingest.go Go gateway · generation_pipeline.go Observability pipeline · main.py CLI entry
Components 19
Operator experience
- CLI entry
cli/defenseclaw/main.py - CLI commands
cli/defenseclaw/commands - Operator TUI
cli/defenseclaw/tui - Configuration
cli/defenseclaw/config.py
Security governance
- Capability registries
cli/defenseclaw/registries - Agent inventory
cli/defenseclaw/inventory - Capability scanners
cli/defenseclaw/scanner - Policy engine
internal/policy/engine.go - Admission enforcement
cli/defenseclaw/enforce/admission.py
Runtime enforcement
- Go gateway
internal/gateway/otel_ingest.go - Connector hooks
extensions/defenseclaw/src/client.ts - ACP proxy
internal/acp/proxy.go - Runtime sensor
internal/sensor/service.go
Evidence and observability
- Audit evidence
internal/audit/actions.go - Observability pipeline
internal/observability/destinations/generation_pipeline.go - Evidence redaction
internal/observability/redaction/engine.go - Telemetry exporters
bundles/splunk_local_bridge/s3_exporter/export_splunk_to_s3.py
Other components
- Operator
- Agent runtime
Connections 17
- Operator → CLI entry: runs commands
README.md - CLI entry → CLI commands: dispatches to
cli/defenseclaw/main.py - Operator → Operator TUI: uses
- CLI commands → Configuration: configures
- CLI commands → Capability registries: manages
- CLI commands → Agent inventory: inspects
- CLI commands → Capability scanners: invokes
- CLI commands → Policy engine: manages
- Agent runtime → Connector hooks: uses hooks
- Connector hooks → Go gateway: routes traffic
- Agent runtime → ACP proxy: uses guarded proxy
- ACP proxy → Go gateway: evaluates via HTTP
- Go gateway → Audit evidence: correlates evidence
- Go gateway → Observability pipeline: imports telemetry
- Observability pipeline → Evidence redaction: redacts records
- Observability pipeline → Telemetry exporters: exports evidence
- Agent runtime → Runtime sensor: observed by