Lib.rs

  ██████╗██╗      █████╗ ██╗    ██╗██████╗  ██████╗ ██████╗  ██████╗
 ██╔════╝██║     ██╔══██╗██║    ██║██╔══██╗██╔═══██╗██╔══██╗██╔════╝
 ██║     ██║     ███████║██║ █╗ ██║██████╔╝██║   ██║██████╔╝██║  ███╗
 ██║     ██║     ██╔══██║██║███╗██║██╔══██╗██║   ██║██╔══██╗██║   ██║
 ╚██████╗███████╗██║  ██║╚███╔███╔╝██████╔╝╚██████╔╝██║  ██║╚██████╔╝
  ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝ ╚═════╝

The fast, single-binary dashboard for OpenClaw AI agent fleets.

Website · Documentation · Changelog · Contributing

What is ClawBorg?

ClawBorg is a local web dashboard that gives you full visibility into your OpenClaw AI agent fleet. Point it at your ~/.openclaw/ directory and instantly see every agent's health, cost, sessions, and tasks — no config required.

It ships as a single binary. The React frontend is compiled into the Rust binary via rust-embed, so there's nothing to install, no Docker, and no database. Run clawborg and open your browser.

ClawBorg is a read-only observer by default. It never modifies your OpenClaw config or interferes with running agents. Opt-in write operations (editing .md files) create automatic backups.

✨ Features

🚀 Quick Start

# Install from source
cargo install --git https://github.com/clawborg/clawborg

# Run (auto-reads ~/.openclaw/)
clawborg
# → open http://localhost:3104

# Or clone and build locally
git clone https://github.com/clawborg/clawborg
cd clawborg && cd web && pnpm install && pnpm build && cd ..
cargo build --release
./target/release/clawborg

# Or run as a background daemon
clawborg start

# Follow live log output
clawborg log -f

# Stop the daemon
clawborg stop

# Point to a custom OpenClaw directory
clawborg --dir /path/to/.openclaw

# Read-only mode (disables file editing)
clawborg --readonly

# Different port
clawborg --port 8080

📸 Screenshots

Agent Fleet Dashboard

Usage & Cost

Cron Job Monitor

Agent Detail & File Browser

⚙️ Configuration

ClawBorg reads your OpenClaw config (~/.openclaw/openclaw.json) and never modifies it. Its own settings live in ~/.clawborg/config.toml:

[alerts]
# Daily spend in USD that triggers a critical alert (red banner)
dailySpendThreshold = 10.0

# Daily spend that triggers a warning alert (yellow banner)
dailySpendWarning = 5.0

CLI flags:

🖥 CLI Reference

🛠 Development

git clone https://github.com/clawborg/clawborg.git
cd clawborg

# Run backend with mock fixtures (no OpenClaw install needed)
cargo run -- --dir ./fixtures/mock-openclaw

# Frontend hot-reload (in a second terminal)
cd web && pnpm install && pnpm dev
# → Vite dev server on http://localhost:3103
# → Backend API on http://localhost:3104

Tech stack:

• Backend: Rust + Axum + tokio
• Frontend: React 19 + Vite + Tailwind CSS + shadcn/ui + Recharts
• Distribution: Single binary via rust-embed

🗺 Roadmap

• v0.3 — Skills viewer, sub-agent tracker, dark/light theme toggle, health report export
• v0.4 — Plugin system, custom dashboard widgets, agent comparison view
• v1.0 — Stable API, Homebrew tap, Docker image, Windows support

🤝 Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines on branching, commit style, and how to run the test suite.

📄 License

AGPL-3.0 — free to use, modify, and distribute under the same license.