Velboard

Name: Velboard
Rating: 3.5 (1 reviews)
Author: karthikeyan5

By karthikeyan5 ⭐ 1 stars 👁 63 views ▲ 0 votes

9 real-time monitoring panels for OpenClaw agents. A Vel plugin.

Homepage GitHub

Configuration Example

{
  "panels": {
    "order": ["claude-usage", "cpu", "memory", "disk", "uptime", "processes", "openclaw-status", "sessions", "crons", "models"],
    "disabled": []
  }
}

README

<p align="center">
  <img src="./screenshots/dashboard-mobile.png" alt="Velboard Dashboard" width="300">
</p>

<h1 align="center">⚡ Velboard</h1>

<p align="center">
  <strong>Real-time dashboard for OpenClaw agents.</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-1.0.0-c9a84c?style=flat-square" alt="Version">
  <img src="https://img.shields.io/badge/built_with-Vel_⚡-ff6b35?style=flat-square" alt="Built with Vel">
  <img src="https://img.shields.io/badge/panels-9-00ADD8?style=flat-square" alt="Panels">
  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License">
</p>

<p align="center">
  <sub>A <a href="https://github.com/essdee/vel">Vel</a> plugin — 9 panels for monitoring your OpenClaw agent.</sub>
</p>

---

## What is this?

Velboard is a **panel pack** for [Vel](https://github.com/essdee/vel) that turns it into a full monitoring dashboard for [OpenClaw](https://github.com/openclaw/openclaw) AI agents.

Stop burning tokens asking your agent routine questions. Open a tab. See everything.

## Panels

| Icon | Panel | Size | What it shows |
|------|-------|------|---------------|
| ⚡ | **CPU** | half | Load %, core count, color-coded bar |
| 🧠 | **Memory** | half | Used/total GB, percentage bar |
| 💾 | **Disk** | half | Usage per mount point |
| ⏱ | **Uptime** | half | System uptime + hostname |
| ⚙️ | **Processes** | half | Running/sleeping/total |
| 🔧 | **OpenClaw Status** | half | Version, sessions, channel |
| 📊 | **Claude Usage** | full | 5-hour + 7-day quotas with reset countdowns |
| 📅 | **Cron Jobs** | full | List, status, run/enable/disable buttons |
| 🤖 | **Models** | full | Primary, fallback, sub-agent routing |

All panels update every 2 seconds via WebSocket. No polling.

## Screenshots

<table>
<tr>
<td><img src="./screenshots/landing-mobile.png" alt="Landing" width="280"></td>
<td><img src="./screenshots/dashboard-mobile.png" alt="Dashboard" width="280"></td>
</tr>
</table>

## Install

### Prerequisites

You need [Vel](https://github.com/essdee/vel) installed and running.

### As an app

```bash
cd your-vel-app/apps/
git clone https://github.com/karthikeyan5/velboard.git
```

Restart Vel. All 9 panels auto-discover.

### Or copy panels individually

```bash
# Copy just the panels you want
cp -r velboard/panels/cpu your-vel-app/apps/velboard/panels/
cp -r velboard/panels/memory your-vel-app/apps/velboard/panels/
```

## Configuration

In your Vel `config.json`, set the panel order:

```json
{
  "panels": {
    "order": ["claude-usage", "cpu", "memory", "disk", "uptime", "processes", "openclaw-status", "sessions", "crons", "models"],
    "disabled": []
  }
}
```

### Claude Usage Panel

Requires the Claude usage monitor. See [`AGENT-SETUP.md`](./AGENT-SETUP.md) for setup instructions.

### OpenClaw Status Panel

Requires `openclaw` CLI in PATH. Shows version, active sessions, memory, and channel info.

## Panel Structure

Each panel is a self-contained folder:

```
panels/cpu/
├── manifest.json    # Panel metadata (id, name, version, size)
└── ui.js            # Preact+HTM component
```

Panels follow the [Vel panel contract](https://github.com/essdee/vel/blob/main/CONTRACTS.md). Data is provided by Vel's built-in system metrics and WebSocket broadcast.

## For AI Agents

Send your OpenClaw agent:

> Install Velboard panels from https://github.com/karthikeyan5/velboard

It reads [`AGENT-SETUP.md`](./AGENT-SETUP.md) and handles everything.

## Roadmap

See [`ROADMAP.md`](./ROADMAP.md) for planned panels and features.

## Framework

Velboard is built on **[Vel](https://github.com/essdee/vel)** — an AI-native Go framework for real-time web apps. For framework docs (architecture, contracts, hooks, apps, testing), see the [Vel repo](https://github.com/essdee/vel).

## License

[MIT](./LICENSE)

---

<p align="center">
  <sub>Built on <a href="https://github.com/essdee/vel">Vel ⚡</a> for <a href="https://github.com/openclaw/openclaw">OpenClaw</a> agents.</sub>
</p>

channels