@qwibitai/nanoclaw-dashboard

Dashboard for NanoClaw — receives JSON snapshots and serves a monitoring UI.

Architecture

The dashboard is a standalone HTTP server with zero NanoClaw dependencies. It receives periodic JSON snapshots via POST /api/ingest and serves a dark-themed monitoring UI.

NanoClaw (pusher)              Dashboard (this package)
┌──────────┐    POST JSON      ┌──────────────┐
│ collects │ ────────────────→ │ /api/ingest  │
│ DB data  │   every 60s       │ in-memory    │
│          │                   │ data store   │
└──────────┘                   │ serves UI    │
                               └──────────────┘

Install

npm install @qwibitai/nanoclaw-dashboard

Usage

As a CLI

DASHBOARD_SECRET=my-secret npx nanoclaw-dashboard

As a library

import { startDashboard } from '@qwibitai/nanoclaw-dashboard';

startDashboard({ port: 3100, secret: 'my-secret' });

With NanoClaw

Use the /add-dashboard skill in your NanoClaw installation:

• Installs this package
• Adds a pusher module that collects data and sends JSON snapshots
• Starts the dashboard as part of the NanoClaw process

Pages

• Overview — agent groups, sessions, channels, token usage, context windows, activity chart
• Agent Groups — detail with sessions, wirings, destinations, members
• Sessions — status, container state, context window usage
• Channels — live/offline status, messaging groups, sender policies
• Messages — per-session inbound/outbound message viewer
• Users — privilege hierarchy (owner → admin → member), group memberships
• Logs — real-time log viewer (requires log push or SSE source)

API

| Endpoint | Method | Description | |----------|--------|-------------| | /api/ingest | POST | Receive JSON snapshot from NanoClaw | | /api/overview | GET | Summary stats | | /api/agent-groups | GET | All agent groups | | /api/sessions | GET | All sessions | | /api/channels | GET | Channel status | | /api/users | GET | Users and roles | | /api/tokens/summary | GET | Token usage | | /api/context | GET | Context window usage | | /api/activity | GET | Message activity (24h) | | /api/status | GET | Health check |

License

MIT