🦞 AgentBoard — OpenClaw Fleet Dashboard

Real-time monitoring dashboard for your OpenClaw AI agents. See what every agent is doing, track token usage, monitor costs, and catch issues before they burn your budget.

Why?

OpenClaw logs everything, but there's no easy way to see it. If you're running agents on a VPS, you're flying blind. AgentBoard gives you:

• Fleet Overview — All agents, their status, sessions, and models at a glance
• Token & Cost Tracking — Input/output tokens, cost breakdown by model and agent
• Real-time Updates — WebSocket-powered, refreshes every 2 seconds
• Usage Analytics — Hourly/daily/weekly/monthly breakdowns
• Health Monitoring — Session file sizes, warnings for bloated logs

Quick Start

# Clone
git clone https://github.com/openclaw/agentboard.git
cd agentboard

# Install & run
cd server && bun install && bun run dev
# → API on http://localhost:4001

# In another terminal
cd dashboard && bun install && bun run dev
# → Dashboard on http://localhost:4002

Open http://localhost:4002 and see your agents.

Requirements

• Bun v1.0+
• OpenClaw running on the same machine
• That's it.

Architecture

┌─────────────────────────────────────────┐
│          AgentBoard Dashboard           │
│         (SvelteKit + Tailwind)          │
│            localhost:4002               │
└──────────────┬──────────────────────────┘
               │ HTTP + WebSocket
┌──────────────▼──────────────────────────┐
│          AgentBoard API Server          │
│            (Hono + Bun)                 │
│            localhost:4001               │
└──────────────┬──────────────────────────┘
               │ File system read
┌──────────────▼──────────────────────────┐
│      ~/.openclaw/agents/                │
│  ├── main/sessions/                     │
│  │   ├── sessions.json                  │
│  │   └── *.jsonl                        │
│  ├── worker-1/sessions/                 │
│  └── worker-N/sessions/                 │
└─────────────────────────────────────────┘

API Endpoints

Method	Path	Description
GET	/api/agents	List all agents with status, tokens, sessions
GET	/api/agents/:id/sessions	Sessions for a specific agent
GET	/api/agents/:id/costs	Cost breakdown for an agent
GET	/api/costs/summary	Aggregated costs across all agents
GET	/api/usage	Detailed usage: by model, by agent, hourly
GET	/api/health	Health check: file sizes, warnings
WS	/ws	Real-time agent status updates (2s interval)

Configuration

Environment variables:

Variable	Default	Description
PORT	4001	API server port
OPENCLAW_AGENTS_PATH	~/.openclaw/agents	Path to OpenClaw agent data

Deploy as systemd service

# Copy the service file
sudo cp agentboard.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now agentboard

# Check status
sudo systemctl status agentboard

Stack

• API: Hono + Bun
• Dashboard: SvelteKit + Tailwind CSS
• Real-time: WebSocket (native Bun)
• Data: Reads OpenClaw's native session files (no database needed)

Contributing

PRs welcome! This project is MIT licensed and open to contributions.

License

MIT — see LICENSE

---

Built with 🦞 by OpenClaw