An open API service indexing awesome lists of open source software.

https://github.com/jontsai/openclaw-command-center

๐Ÿค– AI assistant command and control dashboard โ€” Spawn more Overlords!
https://github.com/jontsai/openclaw-command-center

agent-orchestration ai ai-agents anthropic automation claude dashboard llama llm monitoring nextjs ollama openai openclaw personal-assistant qwen slack typescript

Last synced: 3 months ago
JSON representation

๐Ÿค– AI assistant command and control dashboard โ€” Spawn more Overlords!

Awesome Lists containing this project

README

          

# ๐Ÿฆž OpenClaw Command Center

English | [็ฎ€ไฝ“ไธญๆ–‡](README.zh-CN.md)

**Mission control for your AI agents**

[![CI](https://github.com/jontsai/openclaw-command-center/actions/workflows/ci.yml/badge.svg)](https://github.com/jontsai/openclaw-command-center/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![ClawHub](https://img.shields.io/badge/ClawHub-command--center-blue)](https://www.clawhub.ai/jontsai/command-center)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/jontsai/openclaw-command-center/pulls)

[Features](#features) โ€ข [Quick Start](#quick-start) โ€ข [Security](#-security) โ€ข [Configuration](#configuration)

---

## Why Command Center?

Your AI agents are running 24/7. You need to know what they're doing.

Command Center gives you **real-time visibility** into your OpenClaw deployment โ€” sessions, costs, system health, scheduled tasks โ€” all in one secure dashboard.

### โšก Fast

- **Single API call** โ€” unified state endpoint, not 16+ separate requests
- **2-second updates** โ€” real-time SSE push, not polling
- **5-second cache** โ€” backend stays responsive under load
- **Instant startup** โ€” no build step, no compilation

### ๐Ÿชถ Lightweight

- **Zero dependencies** for users โ€” just Node.js
- **~200KB total** โ€” dashboard + server
- **No webpack/vite/bundler** โ€” runs directly
- **No React/Vue/Angular** โ€” vanilla JS, works everywhere

### ๐Ÿ“ฑ Responsive

- **Desktop & mobile** โ€” works on any screen size
- **Dark mode** โ€” easy on the eyes, Starcraft-inspired
- **Live updates** โ€” no manual refresh needed
- **Offline-friendly** โ€” graceful degradation

### ๐Ÿ”ง Modern

- **ES Modules** โ€” clean component architecture
- **SSE streaming** โ€” efficient real-time updates
- **REST API** โ€” integrate with your tools
- **TypeScript-ready** โ€” JSDoc types included

### ๐Ÿ”’ Security (Most Important)

Command Center takes security seriously:

| Feature | Description |
| ------------------------ | --------------------------------------------------- |
| **Auth Modes** | Token, Tailscale, Cloudflare Access, IP allowlist |
| **No external calls** | Dashboard runs 100% locally โ€” no telemetry, no CDNs |
| **Localhost default** | Binds to `127.0.0.1` by default |
| **Read-only by default** | View your agents without exposing control |
| **No secrets in UI** | API keys, tokens never displayed |
| **Audit logging** | Know who accessed what, when |

```bash
# Secure deployment example (Tailscale)
DASHBOARD_AUTH_MODE=tailscale node lib/server.js
# Only users on your Tailscale network can access
```

---

## Features

| Feature | Description |
| -------------------------- | ------------------------------------------- |
| ๐Ÿ“Š **Session Monitoring** | Real-time view of active AI sessions |
| โ›ฝ **LLM Fuel Gauges** | Token usage, costs, quota remaining |
| ๐Ÿ’ป **System Vitals** | CPU, memory, disk, temperature |
| โฐ **Cron Jobs** | View and manage scheduled tasks |
| ๐Ÿง  **Cerebro Topics** | Automatic conversation tagging |
| ๐Ÿ‘ฅ **Operators** | Who's talking to your agents |
| ๐Ÿ“ **Memory Browser** | View agent memory files |
| ๐Ÿ”’ **Privacy Controls** | Hide sensitive topics for demos/screenshots |
| ๐Ÿ’ฐ **Cost Breakdown** | Detailed per-model cost analysis |
| ๐Ÿ“ˆ **Savings Projections** | Monthly cost vs. manual estimates |

---

## Quick Start

```bash
npx clawhub@latest install command-center
cd skills/command-center
node lib/server.js
```

**Dashboard runs at http://localhost:3333** ๐ŸŽ‰

Alternative: Git clone

```bash
git clone https://github.com/jontsai/openclaw-command-center
cd openclaw-command-center
node lib/server.js
```

---

## Zero-Config Experience

Command Center **auto-detects** your OpenClaw workspace:

1. `$OPENCLAW_WORKSPACE` environment variable
2. `~/.openclaw-workspace` or `~/openclaw-workspace`
3. Common names: `~/molty`, `~/clawd`, `~/moltbot`

If you have `memory/` or `state/` directories, you're good to go.

---

## Configuration

### Environment Variables

| Variable | Description | Default |
| -------------------- | -------------- | ----------- |
| `PORT` | Server port | `3333` |
| `OPENCLAW_WORKSPACE` | Workspace root | Auto-detect |
| `OPENCLAW_PROFILE` | Profile name | (none) |

### ๐Ÿ”’ Authentication

| Mode | Use Case | Config |
| ------------ | ------------- | --------------------------------------------------------- |
| `none` | Local dev | `DASHBOARD_AUTH_MODE=none` |
| `token` | API access | `DASHBOARD_AUTH_MODE=token DASHBOARD_TOKEN=secret` |
| `tailscale` | Team access | `DASHBOARD_AUTH_MODE=tailscale` |
| `cloudflare` | Public deploy | `DASHBOARD_AUTH_MODE=cloudflare` |
| `allowlist` | IP whitelist | `DASHBOARD_AUTH_MODE=allowlist DASHBOARD_ALLOWED_IPS=...` |

### ๐Ÿ“‹ Recommended OpenClaw Settings

For the best Command Center experience, configure your OpenClaw gateway:

#### Slack Threading (Critical)

Enable threading for all messages to get proper topic tracking:

```yaml
# In your OpenClaw config (gateway.yaml or via openclaw gateway config)
slack:
capabilities:
threading: all # Options: all, dm, group, none
```

**Why this matters:** Without threading, the dashboard can't track conversation topics properly. Each thread becomes a trackable unit of work.

#### Session Labels

Use descriptive session labels for better dashboard visibility:

```yaml
sessions:
labelFormat: "{channel}:{topic}" # Customize as needed
```

#### Cerebro (Topic Tracking)

Enable Cerebro for automatic conversation tagging:

```bash
# Initialize Cerebro directories
mkdir -p ~/your-workspace/cerebro/topics
mkdir -p ~/your-workspace/cerebro/orphans
```

The dashboard will automatically detect and display topic data.

---

### Multi-Profile Support

Running multiple OpenClaw instances?

```bash
# Production dashboard
node lib/server.js --profile production --port 3333

# Development dashboard
node lib/server.js --profile dev --port 3334
```

---

## API

Command Center exposes a REST API:

| Endpoint | Description |
| ------------------- | -------------------------------------------------- |
| `GET /api/state` | **Unified state** โ€” all dashboard data in one call |
| `GET /api/health` | Health check |
| `GET /api/vitals` | System metrics |
| `GET /api/sessions` | Active sessions |
| `GET /api/events` | SSE stream for real-time updates |

---

## Architecture

```
command-center/
โ”œโ”€โ”€ lib/
โ”‚ โ”œโ”€โ”€ server.js # HTTP server + API
โ”‚ โ”œโ”€โ”€ config.js # Configuration
โ”‚ โ””โ”€โ”€ jobs.js # Cron integration
โ”œโ”€โ”€ public/
โ”‚ โ”œโ”€โ”€ index.html # Dashboard UI
โ”‚ โ””โ”€โ”€ js/ # Components (ES modules)
โ””โ”€โ”€ scripts/
โ”œโ”€โ”€ setup.sh # First-time setup
โ””โ”€โ”€ verify.sh # Health check
```

---

## ๐Ÿš€ Coming Soon

### Advanced Job Scheduling

Building on OpenClaw's native cron system with intelligent scheduling primitives:

| Primitive | Description |
| -------------------- | ------------------------------------------- |
| **run-if-not** | Skip if job already running (dedupe) |
| **run-if-idle** | Only execute when system capacity available |
| **run-after** | Dependency chains between jobs |
| **run-with-backoff** | Exponential retry on failure |
| **priority-queue** | Critical vs. background work prioritization |

### Multi-Agent Orchestration

- Agent-to-agent handoffs
- Swarm coordination patterns
- Specialized agent routing (data analysis, documentation, testing)
- Cross-session context sharing

### Integration Ecosystem

- Webhook triggers for external systems
- Slack slash commands for quick actions
- API for custom integrations
- Plugin architecture for specialized agents

---

## Screenshots

### Dashboard Overview

The hero view shows key metrics at a glance: total tokens, costs, active sessions, estimated savings, and system capacity.


Dashboard Hero

### Sessions Panel

Monitor all active AI sessions in real-time. Each card shows model, channel, token usage, cost, and activity status. Filter by status (live/recent/idle), channel, or session type.


Sessions Panel

### Cron Jobs

View and manage scheduled tasks. See run history, next scheduled time, and enable/disable jobs. The dashboard shows job success/failure sparklines and filters by status and schedule type.


Cron Jobs Panel

### Cerebro Topics

Automatic conversation organization. Topics are auto-detected from Slack threads, with status tracking (active/resolved/parked), thread counts, and quick navigation. Privacy controls let you hide sensitive topics.


Cerebro Topics Panel

### Operators

See who's interacting with your AI agents. Track active sessions per operator, permission levels, and last activity timestamps.


Operators Panel

### Memory Browser

Browse your agent's memory files โ€” daily logs, long-term memory, and workspace files. Quick navigation with file sizes and modification times.


Memory Panel

### Cost Breakdown Modal

Click on any cost stat to see detailed breakdowns: token usage by type, pricing rates, and calculation methodology. Includes estimated savings vs. manual work.


Cost Breakdown Modal

### Operator Details

Click on an operator card to see their session history, stats, and activity timeline.


Operator Details Modal

### Privacy Settings

Control what's visible for demos and screenshots. Hide sensitive topics, sessions, or cron jobs. Settings sync to the server automatically.


Privacy Settings Modal

### Session Details

Click any session card to see detailed information: summary, key facts, tools used, and recent messages.


Session Details Panel

### Full Dashboard

The complete dashboard with all panels visible.

Click to expand full dashboard view


Full Dashboard

---

## Contributing

Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md).

### Development

```bash
npm install # Install dev dependencies
npm run dev # Watch mode
npm run lint # Check code style
npm run format # Auto-format
./scripts/verify.sh # Run health checks
```

---

## License

MIT ยฉ [Jonathan Tsai](https://github.com/jontsai)

---

**[Install from ClawHub](https://www.clawhub.ai/jontsai/command-center)** ยท **[OpenClaw](https://github.com/openclaw/openclaw)** ยท **[Discord](https://discord.gg/clawd)**