# automateyournetwork/netclaw architecture

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

- Interactive diagram: https://gitdiagram.com/automateyournetwork/netclaw
- Repository: https://github.com/automateyournetwork/netclaw

## Overview

NetClaw is an AI network-engineering coworker spanning OpenClaw and Hermes runtimes, with chat/HUD and VS Code interfaces, specialist MCP integrations, and reviewed setup and change workflows. The graph preserves the README’s main capabilities and selected sampled integration stages; many catalog entries are represented collectively because their implementations were not sampled. Edges are limited to README statements or source-index/excerpt evidence, so unsampled wiring is not inferred.

Main entry points: [`mcp-servers`](https://github.com/automateyournetwork/netclaw/tree/main/mcp-servers) (MCP integration catalog), [`mcp-servers/multivendor-cli-mcp/server.py`](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/server.py) (Multivendor CLI), [`extensions/netclaw-vscode/src/setup/engine.ts`](https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/setup/engine.ts) (Installation setup), [`mcp-servers/nautobot-mcp-v2/server.py`](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/nautobot-mcp-v2/server.py) (Nautobot operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_vscode["VS Code extension<br/>[extension.ts]"]
  node_hud["Visual HUD<br/>[server.js]"]
  node_canvas["Chat and Canvas<br/>[App.jsx]"]
  node_mobile["Mobile client"]
end

subgraph group_runtime["Runtime and setup"]
  node_setup["Installation setup<br/>[engine.ts]"]
  node_setupdata["Setup data<br/>[data.ts]"]
  node_runtimeagent["OpenClaw or Hermes"]
  node_mcp["MCP integration catalog"]
end

subgraph group_network["Network operations"]
  node_multivendor["Multivendor CLI<br/>[server.py]"]
  node_change["Device changes<br/>[change.py]"]
  node_policy["Command safety policy<br/>[platform_deny.py]"]
  node_gnmi["Streaming telemetry"]
  node_nautobot["Nautobot operations<br/>[server.py]"]
  node_nautobotclient["Nautobot client<br/>[nautobot_client.py]"]
end

subgraph group_knowledge["Knowledge and specialists"]
  node_rag["Document-grounded RAG<br/>[rag_mcp_server.py]"]
  node_psirt["Cisco advisories<br/>[server.py]"]
  node_ollama["Local model delegation<br/>[server.py]"]
end

subgraph group_comms["Communications and federation"]
  node_twilio["Voice context<br/>[context_manager.py]"]
  node_zoom["Zoom meeting integration<br/>[server.py]"]
  node_federation["Agent federation<br/>[manager.py]"]
end

node_engineer(("Network engineer"))
node_ciscoapi["Cisco API"]
node_memory["Memory MCP"]
node_devices["Network devices"]
node_nautobotservice["Nautobot service"]
node_localmodels["Local Ollama models"]
node_meeting["Zoom meeting service"]

node_engineer -->|"sets up or connects"| node_vscode
node_engineer -->|"uses"| node_hud
node_engineer -->|"asks from phone"| node_mobile
node_vscode -->|"runs setup"| node_setup
node_setup -->|"uses"| node_setupdata
node_setup -->|"configures"| node_runtimeagent
node_hud -->|"connects to"| node_runtimeagent
node_canvas -->|"part of"| node_hud
node_runtimeagent -->|"uses installed tools"| node_mcp
node_mcp -.->|"includes"| node_rag
node_mcp -.->|"includes"| node_multivendor
node_mcp -.->|"includes"| node_nautobot
node_mcp -.->|"includes"| node_psirt
node_mcp -.->|"includes"| node_gnmi
node_multivendor -->|"dispatches"| node_change
node_multivendor -->|"checks commands"| node_policy
node_multivendor -.->|"queries or changes"| node_devices
node_nautobot -->|"uses"| node_nautobotclient
node_nautobot -.->|"reads or writes"| node_nautobotservice
node_psirt -->|"queries advisories"| node_ciscoapi
node_ollama -->|"generates responses"| node_localmodels
node_twilio -->|"stores or recalls context"| node_memory
node_zoom -.->|"integrates with"| node_meeting
node_runtimeagent -.->|"coordinates peers"| node_federation
node_engineer -->|"investigates in meeting"| node_zoom

click node_vscode "https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/extension.ts"
click node_hud "https://github.com/automateyournetwork/netclaw/blob/main/ui/netclaw-visual/server.js"
click node_canvas "https://github.com/automateyournetwork/netclaw/blob/main/ui/netclaw-visual/src/canvas-chat/App.jsx"
click node_mobile "https://github.com/automateyournetwork/netclaw/blob/main/mobile/netclaw-mobile/ios/Runner/HeadlessEngineRunner.swift"
click node_setup "https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/setup/engine.ts"
click node_setupdata "https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/setup/data.ts"
click node_mcp "https://github.com/automateyournetwork/netclaw/tree/main/mcp-servers"
click node_multivendor "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/server.py"
click node_change "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/tools/change.py"
click node_policy "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/policy/platform_deny.py"
click node_gnmi "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/gnmi-mcp/subscription_manager.py"
click node_nautobot "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/nautobot-mcp-v2/server.py"
click node_nautobotclient "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/nautobot-mcp-v2/nautobot_client.py"
click node_rag "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/rag-mcp/rag_mcp_server.py"
click node_psirt "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/cisco-psirt-mcp/server.py"
click node_ollama "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/ollama-mcp/server.py"
click node_twilio "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/twilio-voice-mcp/context_manager.py"
click node_zoom "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/zoom-rtms-mcp/server.py"
click node_federation "https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/protocol-mcp/bgp/federation/manager.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_vscode,node_hud,node_canvas,node_mobile toneBlue
class node_setup,node_setupdata,node_runtimeagent,node_mcp toneAmber
class node_multivendor,node_change,node_policy,node_gnmi,node_nautobot,node_nautobotclient,node_ciscoapi toneMint
class node_rag,node_psirt,node_ollama toneRose
class node_twilio,node_zoom,node_federation,node_engineer,node_memory,node_devices,node_nautobotservice,node_localmodels,node_meeting toneIndigo
```

## Components

### User interfaces

- [VS Code extension](https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/extension.ts): `extensions/netclaw-vscode/src/extension.ts`
- [Visual HUD](https://github.com/automateyournetwork/netclaw/blob/main/ui/netclaw-visual/server.js): `ui/netclaw-visual/server.js`
- [Chat and Canvas](https://github.com/automateyournetwork/netclaw/blob/main/ui/netclaw-visual/src/canvas-chat/App.jsx): `ui/netclaw-visual/src/canvas-chat/App.jsx`
- [Mobile client](https://github.com/automateyournetwork/netclaw/blob/main/mobile/netclaw-mobile/ios/Runner/HeadlessEngineRunner.swift): `mobile/netclaw-mobile/ios/Runner/HeadlessEngineRunner.swift`

### Runtime and setup

- [Installation setup](https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/setup/engine.ts): `extensions/netclaw-vscode/src/setup/engine.ts`
- [Setup data](https://github.com/automateyournetwork/netclaw/blob/main/extensions/netclaw-vscode/src/setup/data.ts): `extensions/netclaw-vscode/src/setup/data.ts`
- **OpenClaw or Hermes**
- [MCP integration catalog](https://github.com/automateyournetwork/netclaw/tree/main/mcp-servers): `mcp-servers`

### Network operations

- [Multivendor CLI](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/server.py): `mcp-servers/multivendor-cli-mcp/server.py`
- [Device changes](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/tools/change.py): `mcp-servers/multivendor-cli-mcp/tools/change.py`
- [Command safety policy](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/multivendor-cli-mcp/policy/platform_deny.py): `mcp-servers/multivendor-cli-mcp/policy/platform_deny.py`
- [Streaming telemetry](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/gnmi-mcp/subscription_manager.py): `mcp-servers/gnmi-mcp/subscription_manager.py`
- [Nautobot operations](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/nautobot-mcp-v2/server.py): `mcp-servers/nautobot-mcp-v2/server.py`
- [Nautobot client](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/nautobot-mcp-v2/nautobot_client.py): `mcp-servers/nautobot-mcp-v2/nautobot_client.py`

### Knowledge and specialists

- [Document-grounded RAG](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/rag-mcp/rag_mcp_server.py): `mcp-servers/rag-mcp/rag_mcp_server.py`
- [Cisco advisories](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/cisco-psirt-mcp/server.py): `mcp-servers/cisco-psirt-mcp/server.py`
- [Local model delegation](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/ollama-mcp/server.py): `mcp-servers/ollama-mcp/server.py`

### Communications and federation

- [Voice context](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/twilio-voice-mcp/context_manager.py): `mcp-servers/twilio-voice-mcp/context_manager.py`
- [Zoom meeting integration](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/zoom-rtms-mcp/server.py): `mcp-servers/zoom-rtms-mcp/server.py`
- [Agent federation](https://github.com/automateyournetwork/netclaw/blob/main/mcp-servers/protocol-mcp/bgp/federation/manager.py): `mcp-servers/protocol-mcp/bgp/federation/manager.py`

### Other components

- **Network engineer**
- **Cisco API**
- **Memory MCP**
- **Network devices**
- **Nautobot service**
- **Local Ollama models**
- **Zoom meeting service**

## Connections

- Network engineer → VS Code extension: sets up or connects (evidence: `README.md`)
- Network engineer → Visual HUD: uses (evidence: `README.md`)
- Network engineer → Mobile client: asks from phone (evidence: `README.md`)
- VS Code extension → Installation setup: runs setup (evidence: `README.md`)
- Installation setup → Setup data: uses (evidence: `extensions/netclaw-vscode/src/setup/engine.ts`)
- Installation setup → OpenClaw or Hermes: configures (evidence: `extensions/netclaw-vscode/src/setup/engine.ts`)
- Visual HUD → OpenClaw or Hermes: connects to (evidence: `README.md`)
- Chat and Canvas → Visual HUD: part of (evidence: `README.md`)
- OpenClaw or Hermes → MCP integration catalog: uses installed tools (evidence: `README.md`)
- MCP integration catalog → Document-grounded RAG: includes
- MCP integration catalog → Multivendor CLI: includes (evidence: `mcp-servers/multivendor-cli-mcp/server.py`)
- MCP integration catalog → Nautobot operations: includes (evidence: `mcp-servers/nautobot-mcp-v2/server.py`)
- MCP integration catalog → Cisco advisories: includes (evidence: `mcp-servers/cisco-psirt-mcp/server.py`)
- MCP integration catalog → Streaming telemetry: includes (evidence: `mcp-servers/gnmi-mcp/subscription_manager.py`)
- Multivendor CLI → Device changes: dispatches (evidence: `mcp-servers/multivendor-cli-mcp/server.py`)
- Multivendor CLI → Command safety policy: checks commands (evidence: `mcp-servers/multivendor-cli-mcp/server.py`)
- Multivendor CLI → Network devices: queries or changes
- Nautobot operations → Nautobot client: uses (evidence: `mcp-servers/nautobot-mcp-v2/server.py`)
- Nautobot operations → Nautobot service: reads or writes
- Cisco advisories → Cisco API: queries advisories (evidence: `mcp-servers/cisco-psirt-mcp/server.py`)
- Local model delegation → Local Ollama models: generates responses (evidence: `mcp-servers/ollama-mcp/server.py`)
- Voice context → Memory MCP: stores or recalls context (evidence: `mcp-servers/twilio-voice-mcp/context_manager.py`)
- Zoom meeting integration → Zoom meeting service: integrates with
- OpenClaw or Hermes → Agent federation: coordinates peers (evidence: `README.md`)
- Network engineer → Zoom meeting integration: investigates in meeting (evidence: `README.md`)
