Skip to content

Repository files navigation

Helm

Observability dashboard for OpenClaw.

Helm Dashboard

What it does

Helm reads directly from your ~/.openclaw/ workspace and shows real system state — sessions, costs, cron jobs, credentials, memory, skills, nodes, and more. No database, no auth, no stubs.

Pages

Page Shows
Dashboard 16 widget cards — weather, system, costs, agents, crons, sessions, nodes, Tailscale, channels, credentials, memory, models, skills, workspaces, activity, message queue
Activities Tool calls, messages, cron runs — 30-day histogram + hourly heatmap
Agents Configured agents, model bindings, session counts
Channels Telegram, WhatsApp, Discord — health, queue status
Spend Stacked daily histogram by model, per-model + per-session-type breakdown
Credentials API keys and tokens — valid / expired / expiring soon
Crons Scheduled jobs — next run, last status, agent, model
Heartbeats Agent heartbeat history and manual trigger
Memory All memory files with content viewer
Messages Delivery queue — stuck messages, errors
Models Configured LLMs + Ollama, cross-linked with skills that use them
Nodes Paired devices — last seen, platform, role
Sessions All sessions with token counts and cost (3 decimal EUR/USD)
Skills Workspace, extension, and global skills — with model usage per skill
Workspaces Agent workspaces and sizes

Features

  • ⌘K command palette — jump anywhere
  • Keyboard navigation — ← → between pages, ESC for settings, ? for shortcuts
  • 9 theme colors (OKLCH) — persisted to localStorage
  • PWA / Add to Home Screen — standalone app mode with dynamic themed icon
  • Mobile-friendly — hamburger menu, safe area support, touch targets
  • Cross-platform — works on macOS, Linux, and Windows (no hardcoded paths)
  • Server-side cache — in-memory with 2-min background warmer, sub-10ms API responses
  • Client-side cache — localStorage with 24h validity for dashboard widgets
  • Demo modeDEMO_MODE=1 returns PII-free fixture data for safe screenshots
  • Sortable tables with search filtering on all pages
  • Tooltips — (i) icon on every page header explaining what it shows

Setup

git clone https://github.com/michellzappa/helm
cd helm
pnpm install
cp .env.local.example .env.local
pnpm dev

Open localhost:1111.

Auto-start (macOS)

cp launchagent.example.plist ~/Library/LaunchAgents/com.yourname.helm.plist
# Edit the path, then:
launchctl load ~/Library/LaunchAgents/com.yourname.helm.plist

Auto-start (Linux)

# systemd service, or add to your init:
pnpm start  # runs on port 1111

Stack

  • Next.js 16 (Pages Router, Turbopack)
  • React 19
  • shadcn/ui + Tailwind CSS v4
  • Lucide icons
  • cmdk (command palette)
  • croner (cron schedule parsing)
  • Playwright (screenshots)

No database. No auth. Reads from the filesystem.

Screenshot

npm run screenshot starts an ephemeral server with DEMO_MODE=1 and captures a PII-free screenshot. Use --live for real data.

License

MIT

About

Observability dashboard for OpenClaw. Reads your local workspace directly: sessions, spend, crons, agents.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages