🌀 OpenClaw Viz — Multi-Agent Work Visualization

Industrial-grade dashboard for observing and controlling OpenClaw multi-agent systems.

Features

🤖 Agent Topology Graph

• Force-directed graph (D3.js) showing real-time agent relationships
• Node types: Agent · Session · Cron Job · Module
• Status indicators: active, idle, stale, error
• Drag, zoom, pan · Click-to-inspect

📊 Session Monitoring

• Real-time session list with status, token usage, cost
• Session history viewer with role-colored messages
• Module attribution · Fuzzy search & multi-filter · 4 sort modes
• JSON / Markdown export

⚡ Human Intervention Console

• Send messages to any active session
• Steer sub-agents with directional instructions
• Terminate runaway agents

🗂️ Project Intelligence

• Module dependency graph (11 workspace projects, 6 relationship types)
• Project timeline / Gantt with milestone markers
• Activity heatmap from daily memory files · Milestone tracker
• Task flow pipeline (Input → Processing → Completed)

🔔 Smart Alerts Engine

• Error spike detection · Stale session monitoring
• Token usage warnings · Model provider failure alerts
• Configurable alert thresholds

👥 Multi-User & RBAC

• User registration with viewer / operator / admin roles
• 10 fine-grained permissions across 3 roles
• Immutable audit trail with SHA-based hash chains
• SSO / JWT authentication (Google OIDC, GitHub, Microsoft stubs)

🎞️ Session Replay & A/B Testing

• Playback engine with 378-frame support
• 5 speed settings (0.5x–10x) · Timeline scrubber
• This week vs. last week metrics comparison

🛡️ Enterprise

• Multi-cluster monitoring with DNS-SD auto-discovery
• Prometheus / Grafana integration (7-panel dashboard export)
• API rate limiting (per-role) · Session-level audit export (JSON/CSV/JSONL)
• Intervention policy engine with 5 built-in rules

Prerequisites

• Node.js ≥ 22 (recommended 24)
• OpenClaw 2026.5.x running locally with a Gateway
• journalctl (optional, for live log viewer)

Quick Start

# Install dependencies
npm run install:all

# Development (hot reload)
npm run dev

# Production build
npm run build
npm start

⚠️ OpenClaw Gateway must be running on the same machine for Viz to connect. The dashboard reads session data from ~/.openclaw/agents/ and ~/.openclaw/cron/.

The dashboard will be available at http://localhost:3000.

Architecture

┌─────────────────────────────────────────────────────┐
│                   Browser (React)                    │
│  ┌──────────┐  ┌───────────┐  ┌──────────────────┐ │
│  │ Topology  │  │  Session  │  │  Intervention    │ │
│  │  Graph    │  │  Monitor  │  │  Console         │ │
│  │  (D3.js)  │  │           │  │                  │ │
│  └─────┬─────┘  └─────┬─────┘  └───────┬──────────┘ │
│        │               │                │            │
│  ┌─────┴───────────────┴────────────────┴──────────┐ │
│  │              Zustand Store + WebSocket            │ │
│  └─────────────────────┬───────────────────────────┘ │
└────────────────────────┼────────────────────────────┘
                         │ WebSocket + REST
┌────────────────────────┼────────────────────────────┐
│                   Express Server                      │
│  ┌─────────────────────┴───────────────────────────┐ │
│  │              Data Collection Layer                │ │
│  │  sessions.json │ JSONL logs │ cron │ processes   │ │
│  └─────────────────────┬───────────────────────────┘ │
│                         │                             │
│  ┌─────────────────────┴───────────────────────────┐ │
│  │              OpenClaw Gateway                     │ │
│  │  ~/.openclaw/agents/ │ ~/.openclaw/cron/         │ │
│  └──────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘

Tech Stack

Configuration

Development

# Run only server
npm run server

# Run only client
npm run client

# Full stack dev
npm run dev

# Build for production
npm run build

Version Evolution

Planned: SAML SSO, webhook alerting (Slack/PagerDuty), policy chaining, replay bookmarks, PDF export.

Contributing

See CONTRIBUTING.md.

License

MIT