# cisco-ai-defense/defenseclaw architecture

> Architecture diagram of the GitHub repository cisco-ai-defense/defenseclaw, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cisco-ai-defense/defenseclaw
- Repository: https://github.com/cisco-ai-defense/defenseclaw

## Overview

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: [`cli/defenseclaw/commands`](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/commands) (CLI commands), [`internal/gateway/otel_ingest.go`](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/gateway/otel_ingest.go) (Go gateway), [`internal/observability/destinations/generation_pipeline.go`](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/observability/destinations/generation_pipeline.go) (Observability pipeline), [`cli/defenseclaw/main.py`](https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/main.py) (CLI entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator experience"]
  node_cli_entry["CLI entry<br/>[main.py]"]
  node_cli_commands["CLI commands"]
  node_operator_tui["Operator TUI"]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_governance["Security governance"]
  node_registry["Capability registries"]
  node_inventory["Agent inventory"]
  node_scanners["Capability scanners"]
  node_policy["Policy engine<br/>[engine.go]"]
  node_enforcement["Admission enforcement<br/>[admission.py]"]
end

subgraph group_runtime["Runtime enforcement"]
  node_gateway["Go gateway<br/>[otel_ingest.go]"]
  node_connector_hooks["Connector hooks<br/>[client.ts]"]
  node_acp_proxy["ACP proxy<br/>[proxy.go]"]
  node_sensor["Runtime sensor<br/>[service.go]"]
end

subgraph group_evidence["Evidence and observability"]
  node_audit["Audit evidence<br/>[actions.go]"]
  node_observability["Observability pipeline"]
  node_redaction["Evidence redaction<br/>[engine.go]"]
  node_telemetry["Telemetry exporters"]
end

node_operator_user(("Operator"))
node_agent_runtime(("Agent runtime"))

node_operator_user -->|"runs commands"| node_cli_entry
node_cli_entry -->|"dispatches to"| node_cli_commands
node_operator_user -.->|"uses"| node_operator_tui
node_cli_commands -.->|"configures"| node_config
node_cli_commands -.->|"manages"| node_registry
node_cli_commands -.->|"inspects"| node_inventory
node_cli_commands -.->|"invokes"| node_scanners
node_cli_commands -.->|"manages"| node_policy
node_agent_runtime -.->|"uses hooks"| node_connector_hooks
node_connector_hooks -.->|"routes traffic"| node_gateway
node_agent_runtime -.->|"uses guarded proxy"| node_acp_proxy
node_acp_proxy -->|"evaluates via HTTP"| node_gateway
node_gateway -.->|"correlates evidence"| node_audit
node_gateway -->|"imports telemetry"| node_observability
node_observability -.->|"redacts records"| node_redaction
node_observability -.->|"exports evidence"| node_telemetry
node_agent_runtime -.->|"observed by"| node_sensor

click node_cli_entry "https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/main.py"
click node_cli_commands "https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/commands"
click node_operator_tui "https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/tui"
click node_config "https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/config.py"
click node_registry "https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/registries"
click node_inventory "https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/inventory"
click node_scanners "https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/scanner"
click node_policy "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/policy/engine.go"
click node_enforcement "https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/enforce/admission.py"
click node_gateway "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/gateway/otel_ingest.go"
click node_connector_hooks "https://github.com/cisco-ai-defense/defenseclaw/blob/main/extensions/defenseclaw/src/client.ts"
click node_acp_proxy "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/acp/proxy.go"
click node_sensor "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/sensor/service.go"
click node_audit "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/audit/actions.go"
click node_observability "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/observability/destinations/generation_pipeline.go"
click node_redaction "https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/observability/redaction/engine.go"
click node_telemetry "https://github.com/cisco-ai-defense/defenseclaw/blob/main/bundles/splunk_local_bridge/s3_exporter/export_splunk_to_s3.py"

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_cli_entry,node_cli_commands,node_operator_tui,node_config toneBlue
class node_registry,node_inventory,node_scanners,node_policy,node_enforcement toneAmber
class node_gateway,node_connector_hooks,node_acp_proxy,node_sensor toneMint
class node_audit,node_observability,node_redaction,node_telemetry toneRose
class node_operator_user,node_agent_runtime toneIndigo
```

## Components

### Operator experience

- [CLI entry](https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/main.py): `cli/defenseclaw/main.py`
- [CLI commands](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/commands): `cli/defenseclaw/commands`
- [Operator TUI](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/tui): `cli/defenseclaw/tui`
- [Configuration](https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/config.py): `cli/defenseclaw/config.py`

### Security governance

- [Capability registries](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/registries): `cli/defenseclaw/registries`
- [Agent inventory](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/inventory): `cli/defenseclaw/inventory`
- [Capability scanners](https://github.com/cisco-ai-defense/defenseclaw/tree/main/cli/defenseclaw/scanner): `cli/defenseclaw/scanner`
- [Policy engine](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/policy/engine.go): `internal/policy/engine.go`
- [Admission enforcement](https://github.com/cisco-ai-defense/defenseclaw/blob/main/cli/defenseclaw/enforce/admission.py): `cli/defenseclaw/enforce/admission.py`

### Runtime enforcement

- [Go gateway](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/gateway/otel_ingest.go): `internal/gateway/otel_ingest.go`
- [Connector hooks](https://github.com/cisco-ai-defense/defenseclaw/blob/main/extensions/defenseclaw/src/client.ts): `extensions/defenseclaw/src/client.ts`
- [ACP proxy](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/acp/proxy.go): `internal/acp/proxy.go`
- [Runtime sensor](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/sensor/service.go): `internal/sensor/service.go`

### Evidence and observability

- [Audit evidence](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/audit/actions.go): `internal/audit/actions.go`
- [Observability pipeline](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/observability/destinations/generation_pipeline.go): `internal/observability/destinations/generation_pipeline.go`
- [Evidence redaction](https://github.com/cisco-ai-defense/defenseclaw/blob/main/internal/observability/redaction/engine.go): `internal/observability/redaction/engine.go`
- [Telemetry exporters](https://github.com/cisco-ai-defense/defenseclaw/blob/main/bundles/splunk_local_bridge/s3_exporter/export_splunk_to_s3.py): `bundles/splunk_local_bridge/s3_exporter/export_splunk_to_s3.py`

### Other components

- **Operator**
- **Agent runtime**

## Connections

- Operator → CLI entry: runs commands (evidence: `README.md`)
- CLI entry → CLI commands: dispatches to (evidence: `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
