openclaw-dashboard  by mudrii

Local command center for AI agent operations

Created 1 month ago
283 stars

Top 92.5% on SourcePulse

GitHubView on GitHub
Project Summary

A beautiful, zero-dependency command center for OpenClaw AI agents, this project addresses the challenge of scattered information when managing complex OpenClaw deployments. It provides a single, local, automatically refreshing dashboard for gateway health, costs, cron job status, active sessions, and model usage, enabling quick decision-making for power users.

How It Works

The dashboard operates via a local HTTP server, available as a single Go binary or a Python script. It serves a pure HTML/CSS/JS frontend that fetches data from OpenClaw's internal state. The backend executes a data collection script (refresh.sh or Go equivalent) to gather metrics like gateway health, costs, cron job status, and active sessions, presenting them in a unified, real-time view. The Go implementation utilizes a stale-while-revalidate strategy for rapid data retrieval.

Quick Start & Requirements

  • Installation: Recommended: Download a pre-built Go binary, make executable, and run. Alternatives include cloning the repo and running server.py, using a provided install.sh script, or deploying via Docker or Nix.
  • Prerequisites: macOS 10.15+ or Linux. OpenClaw must be installed at ~/.openclaw. The Python server requires Python 3.6+. A modern web browser is needed.
  • Resource Footprint: Go binary is ~10MB. Docker images are 30MB (Go) or 180MB (Python).
  • Documentation: Links to CONTRIBUTING.md, ARCHITECTURE.md, and docs/CONFIGURATION.md are available.

Highlighted Details

  • Features 12 distinct dashboard panels, including real-time system metrics (CPU, RAM, Disk), cost breakdowns, cron job status, active sessions, token usage, and sub-agent activity.
  • A unique AI Chat feature allows natural language querying of dashboard data via the OpenClaw gateway.
  • Offers 6 built-in themes with support for custom themes via themes.json, featuring a glassmorphism UI and responsive design.
  • Frontend is entirely self-contained (single JS file) with zero external dependencies.
  • The Go server provides enhanced runtime observability and faster data refresh mechanisms.

Maintenance & Community

The project is primarily maintained by mudrii. Contribution guidelines are provided in CONTRIBUTING.md. No specific community channels (like Discord or Slack) or sponsorship details are mentioned in the README.

Licensing & Compatibility

The project is released under the MIT License, which is permissive for commercial use, modification, and distribution, including integration into closed-source applications.

Limitations & Caveats

Support is limited to macOS and Linux; Windows is not explicitly mentioned. The dashboard requires a pre-existing OpenClaw installation at ~/.openclaw and specific gateway configurations for its AI chat functionality. Data collection relies on the OpenClaw CLI or equivalent access.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
4
Star History
240 stars in the last 30 days

Explore Similar Projects

Starred by Dan Guido Dan Guido(Cofounder of Trail of Bits), Joe Walnes Joe Walnes(Head of Experimental Projects at Stripe), and
4 more.

opcode by winfunc

0.6%
21k
GUI for Claude Code
Created 9 months ago
Updated 5 months ago
Feedback? Help us improve.