🦞 claw-dash

The dashboard for OpenClaw users.

Monitor your AI assistant's token usage, costs, sessions, and system health — from anywhere.

Live Dashboard	Historical Charts

Why This Exists

Built for OpenClaw users who want to monitor their AI assistant from anywhere.

The Problem

You're running OpenClaw on a Mac Mini (or any headless server) tucked away without a monitor. You want to:

Check how many tokens you've used today
See active sessions and costs
Monitor system resources (CPU, RAM, disk)
View scheduled jobs (cron)

But you don't want to SSH in every time just to run openclaw status.

The Solution

This dashboard gives you a single URL to check everything — from your phone, tablet, laptop, or any device. Set it up once with Tailscale, and you can monitor your OpenClaw instance from anywhere in the world.

https://your-mac-mini.tailnet.ts.net

Perfect for:

🖥️ Headless Mac Mini / Linux server running OpenClaw
📱 Quick status checks from your phone
🌍 Remote monitoring while traveling
🤖 Keeping an eye on your AI assistant's token usage and costs

Features

Real-time Monitoring: CPU, RAM, Disk, Network with live gauges and sparklines
Historical Charts: View metrics over 1H, 8H, 24H, 7D, or 30D
OpenClaw Integration: Session stats, token tracking, cost estimates, scheduled jobs
Process Insights: Top processes with historical comparison and anomaly detection
Multiple Themes: Dark, Light, Retro CRT, Hacker, Synthwave
Achievements: Fun badges for system milestones
Fireteam Roster: See your configured OpenClaw agents at a glance — names, roles, models, and callsigns
Customizable Layout: Drag & drop widgets, show/hide panels
Mobile Friendly: Responsive design works on any screen
Last Updated Indicator: Timestamp showing when data was last refreshed, auto-updates in real time
Larry the Lobster: Pet mascot that reacts to CPU usage 🦞

Platform Support

	macOS	Linux	Windows
Start script	`./start.sh`	`./start.sh`	`.\start.ps1`
Glances	`brew`	`apt` / `pip`	`pip`
Tailscale	`brew` / App	`apt` / script	Installer
Service manager	launchd	systemd	Task Scheduler
Collector	✅	✅	✅
API Server	✅	✅	✅
Dashboard	✅	✅	✅
Tested	✅ macOS 13+	✅ Ubuntu 22+	⚠️ Untested

Requirements

Node.js 18+
Python 3.8+
Glances for system metrics
OpenClaw (optional, for AI stats)
Tailscale (optional, for secure remote access)

Quick Start

1. Install Dependencies

Platform	Node.js	Python	Glances
macOS	`brew install node`	Built-in	`brew install glances`
Ubuntu/Debian	`sudo apt install nodejs`	`sudo apt install python3`	`sudo apt install glances`
Fedora/RHEL	`sudo dnf install nodejs`	Built-in	`sudo dnf install glances`
Windows	nodejs.org	python.org	`pip install glances`

2. Clone & Run

git clone https://github.com/YOUR_USERNAME/claw-dash.git
cd claw-dash

macOS / Linux	Windows (PowerShell)	Windows (CMD)
./start.sh	.\start.ps1	start.bat

3. Open Dashboard

Visit http://localhost:8888 in your browser.

Accessing the Dashboard

By default, the dashboard binds to 127.0.0.1 (localhost only) for security.

Access Methods

Method	Binding	URL	Security
Localhost	`127.0.0.1` (default)	`http://localhost:8888`	✅ Most secure
LAN	`192.168.x.x`	`http://192.168.x.x:8888`	⚠️ Local network only
Tailscale HTTPS	`127.0.0.1` + serve	`https://hostname.tailnet.ts.net`	✅ Secure + remote

Option 1: Localhost Only (Default)

./start.sh   # Binds to 127.0.0.1

Access at http://localhost:8888 — only works on the same machine.

Option 2: LAN Access

Bind to your local IP to access from other devices on your network:

macOS / Linux	Windows PowerShell
BIND_ADDRESS=192.168.50.2 ./start.sh	$env:BIND_ADDRESS="192.168.50.2"; .\start.ps1

Access at http://192.168.50.2:8888 from any device on your LAN.

⚠️ Security note: Only use on trusted networks. Anyone on the same network can access the dashboard.

Option 3: Remote Access via Tailscale (Recommended) 🌐

Tailscale provides secure, encrypted remote access with HTTPS — without exposing ports to the internet.

1. Install Tailscale:

Platform	Install
macOS	`brew install tailscale` or Mac App Store
Linux	tailscale.com/download/linux
Windows	tailscale.com/download/windows
iOS/Android	App Store / Play Store

2. Start dashboard (localhost):

./start.sh   # Binds to 127.0.0.1

3. Expose via Tailscale serve:

# Expose dashboard with HTTPS
tailscale serve --bg 8888

# Expose dashboard API (required for live stats/history)
tailscale serve --bg --set-path /api http://127.0.0.1:8889

# Check your Tailscale hostname
tailscale status

4. Access from anywhere:

https://your-hostname.tailnet-name.ts.net

💡 Benefits of Tailscale serve:

Automatic HTTPS certificates

Only authenticated Tailscale users can access

Works from phone, laptop, anywhere

No port forwarding or firewall changes needed

The dashboard expects API at /api when served over HTTPS.

Quick Reference

I want to...	Command	Access URL
Test locally	`./start.sh`	`http://localhost:8888`
Access from LAN	`BIND_ADDRESS=192.168.50.2 ./start.sh`	`http://192.168.50.2:8888`
Access anywhere (secure)	`./start.sh` + `tailscale serve --bg 8888`	`https://hostname.ts.net`

HTTPS Options

Recommended: Tailscale Serve ⭐

The easiest way to get HTTPS. No certificates to manage, no ports to open, works from anywhere.

./start.sh                    # Start dashboard on localhost
tailscale serve --bg 8888     # Expose with automatic HTTPS

Done! Access at https://your-hostname.tailnet.ts.net

Why Tailscale?

✅ Zero configuration
✅ Automatic HTTPS certificates
✅ No port forwarding needed
✅ Works behind firewalls/NAT
✅ Only your devices can access
✅ Free for personal use

Alternative: Caddy (Self-hosted HTTPS)

If you have a domain and want public HTTPS without Tailscale:

1. Install Caddy:

# macOS
brew install caddy

# Linux
sudo apt install caddy

2. Create Caddyfile:

your-domain.com {
    reverse_proxy localhost:8888
}

3. Run:

BIND_ADDRESS=127.0.0.1 ./start.sh   # Start dashboard
caddy run                            # Start Caddy (auto-fetches Let's Encrypt cert)

⚠️ Requires: Domain pointing to your server, ports 80/443 open

Alternative: mkcert (LAN HTTPS)

For trusted HTTPS on your local network without a domain:

1. Install mkcert:

# macOS
brew install mkcert

# Linux
sudo apt install mkcert

2. Create local CA and certificates:

mkcert -install                    # Install local CA (one-time)
mkcert 192.168.50.2 localhost      # Generate cert for your IPs

3. Use with a simple HTTPS server:

# Python (requires ssl wrapper)
# Or use Caddy with the local cert:
caddy reverse-proxy --from https://192.168.50.2:8443 --to localhost:8888 \
  --internal-certs

⚠️ Each client device needs to trust the mkcert CA for this to work without browser warnings.

Comparison

Method	Setup Time	Domain Required	Works Remotely	Certificate
Tailscale ⭐	2 min	No	Yes	Auto
Caddy	10 min	Yes	Yes	Auto (Let's Encrypt)
mkcert	15 min	No	LAN only	Self-signed (trusted)
nginx + certbot	30 min	Yes	Yes	Auto (Let's Encrypt)

Our recommendation: Use Tailscale. It's free, takes 2 minutes, and just works.

Managing Services

Action	macOS / Linux	Windows PowerShell	Windows CMD
Start	`./start.sh`	`.\start.ps1`	`start.bat`
Stop	`./start.sh --stop`	`.\start.ps1 -Stop`	`start.bat stop`
Status	`./start.sh --status`	`.\start.ps1 -Status`	`start.bat status`
Restart	`./start.sh --restart`	`.\start.ps1 -Restart`	`start.bat` (stop + start)
Help	`./start.sh --help`	`.\start.ps1 -Help`	`start.bat --help`

Custom Ports

macOS / Linux	Windows PowerShell
DASHBOARD_PORT=3000 API_PORT=3001 ./start.sh	$env:DASHBOARD_PORT=3000; $env:API_PORT=3001; .\start.ps1

Default ports: Dashboard 8888, API 8889, Glances 61208

Manual Start (All Platforms)

If you prefer manual control or can't use bash:

# Terminal 1: Glances
glances -w --bind 0.0.0.0

# Terminal 2: API server
node api-server.js

# Terminal 3: Collector
python3 collector.py

# Terminal 4: Dashboard
python3 -m http.server 8888

Configuration

Copy config.example.json to config.json and customize:

{
  "api": {
    "port": 8889
  },
  "glances": {
    "url": "http://localhost:61208"
  },
  "features": {
    "coffeeLink": "https://buymeacoffee.com/YOUR_USERNAME",
    "showLobster": true
  }
}

Running as a Service (Persistent)

macOS (launchd)

Example plist files are in the launchd/ folder:

# Copy and edit paths in plist files
cp launchd/*.plist.example ~/Library/LaunchAgents/
# Edit paths, then:
launchctl load ~/Library/LaunchAgents/com.dashboard.*.plist

Linux (systemd)

Example service file (/etc/systemd/system/dashboard.service):

[Unit]
Description=System Monitor Dashboard
After=network.target

[Service]
Type=simple
User=YOUR_USER
WorkingDirectory=/path/to/claw-dash
ExecStart=/path/to/claw-dash/start.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl daemon-reload
sudo systemctl enable dashboard
sudo systemctl start dashboard

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Browser       │────▶│  Dashboard      │────▶│  API Server     │
│   (index.html)  │     │  (port 8888)    │     │  (port 8889)    │
└─────────────────┘     └─────────────────┘     └────────┬────────┘
                                                         │
                        ┌─────────────────┐              │
                        │   SQLite DB     │◀─────────────┤
                        │   (history.db)  │              │
                        └─────────────────┘              │
                                                         │
                        ┌─────────────────┐     ┌────────▼────────┐
                        │   Collector     │────▶│   Glances API   │
                        │   (collector.py)│     │   (port 61208)  │
                        └─────────────────┘     └─────────────────┘
                                                         │
                        ┌─────────────────┐              │
                        │   OpenClaw      │◀─────────────┘
                        │   (optional)    │
                        └─────────────────┘

API Endpoints

Endpoint	Description
`/api/openclaw`	OpenClaw stats (sessions, tokens, cost)
`/api/history?range=1h`	Historical metrics
`/api/tokens`	Token breakdown with cost estimate
`/api/cron`	Scheduled jobs list
`/api/processes`	Process insights with anomaly detection
`/api/connections`	Active network connections
`/api/agents`	Fireteam roster (configured agents, roles, models)
`/api/quote`	Random programming quote

Themes

Click the theme icon to switch between:

🌙 Dark - Easy on the eyes
☀️ Light - Bright and clean
📺 Retro CRT - Green phosphor nostalgia
💀 Hacker - Matrix-style
🌆 Synthwave - Neon vibes

Customizing Widgets

Click ✏️ Edit Layout button
Drag widgets to reorder
Toggle visibility with emoji buttons
Click ✓ when done
Click ↻ Reset to restore defaults

Layout is saved to localStorage.

Troubleshooting

Glances won't start

Check if port is in use:

macOS / Linux	Windows
`lsof -i :61208`	`netstat -ano \| findstr :61208`

Try a different port:

macOS / Linux	Windows PowerShell
`GLANCES_PORT=61209 ./start.sh`	`$env:GLANCES_PORT=61209; .\start.ps1`

Dashboard shows "Connecting..."

Check service status:
- macOS/Linux: ./start.sh --status
- Windows: .\start.ps1 -Status
Check logs in ./logs/ folder

OpenClaw card shows N/A

OpenClaw not installed or not in PATH
Verify installation:
- macOS/Linux: which openclaw
- Windows: where openclaw

Permission denied (macOS/Linux)

chmod +x start.sh

PowerShell execution policy (Windows)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Can't access remotely via Tailscale

Ensure Tailscale is running on both machines
Check Tailscale status: tailscale status
Verify the dashboard is bound to 0.0.0.0 (not just localhost)
Check if firewall is blocking ports 8888/8889
- macOS: System Preferences → Security → Firewall
- Linux: sudo ufw allow 8888 and sudo ufw allow 8889
- Windows: Allow through Windows Firewall

Contributing

Contributions welcome! Please open an issue or PR.

License

MIT License - See LICENSE

Credits

Glances - System monitoring
Chart.js - Beautiful charts
SortableJS - Drag & drop
OpenClaw - AI gateway integration

Made with 🦞 by Hao Yu

If you find this useful, buy me a coffee! ☕

Name		Name	Last commit message	Last commit date
Latest commit History 18 Commits
launchd		launchd
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
api-server.js		api-server.js
collector.py		collector.py
config.example.json		config.example.json
index.html		index.html
preview-history.png		preview-history.png
preview.png		preview.png
setup.sh		setup.sh
start.bat		start.bat
start.ps1		start.ps1
start.sh		start.sh

Folders and files

Latest commit

History

Repository files navigation

🦞 claw-dash

Why This Exists

The Problem

The Solution

Features

Platform Support

Requirements

Quick Start

1. Install Dependencies

2. Clone & Run

3. Open Dashboard

Accessing the Dashboard

Access Methods

Option 1: Localhost Only (Default)

Option 2: LAN Access

Option 3: Remote Access via Tailscale (Recommended) 🌐

Quick Reference

HTTPS Options

Recommended: Tailscale Serve ⭐

Alternative: Caddy (Self-hosted HTTPS)

Alternative: mkcert (LAN HTTPS)

Comparison

Managing Services

Custom Ports

Manual Start (All Platforms)

Configuration

Running as a Service (Persistent)

macOS (launchd)

Linux (systemd)

Architecture

API Endpoints

Themes

Customizing Widgets

Troubleshooting

Glances won't start

Dashboard shows "Connecting..."

OpenClaw card shows N/A

Permission denied (macOS/Linux)

PowerShell execution policy (Windows)

Can't access remotely via Tailscale

Contributing

License

Credits

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages