openclaw-mission-control
v0.1.0
Published
Mission Control dashboard for OpenClaw — manage agents, tasks, and missions from a command-center UI
Maintainers
Readme
Mission Control is an open-source, real-time command-center dashboard for OpenClaw — the open-source AI agent framework. It gives you a visual interface to create tasks, dispatch them to AI agents, monitor agent activity, and track progress through a Kanban-style workflow.
Think of it as your personal AI operations center — a single pane of glass for everything your AI agents are doing.
🚀 Quick Start
Run Mission Control instantly with a single command — no cloning required:
npx openclaw-mission-controlThe interactive setup wizard will ask for:
| Prompt | Default | Description |
| --------------- | ---------------------- | --------------------------------------------- |
| Gateway URL | ws://127.0.0.1:18789 | Your OpenClaw gateway WebSocket address |
| Auth Token | — | Authentication token from your gateway config |
| Port | 3000 | Port to serve the dashboard on |
Once configured, Mission Control starts in under 1 second and opens at http://localhost:3000.
✨ Features
📋 Kanban Task Board
Organize AI agent work across five workflow stages with drag-and-drop:
- Inbox → Assigned → In Progress → Review → Done
- Create tasks with priority levels (Low, Medium, High, Urgent)
- Drag tasks between columns to update status
- Task cards show assigned agent, priority badge, and time elapsed
🤖 Agent Monitoring
- Real-time agent status (Online / Offline / Busy)
- View connected agents with model info and capabilities
- Dispatch tasks directly to specific agents
- Track which agent is working on what
📡 Live Terminal
- Floating, collapsible terminal panel (slides from right)
- Real-time activity feed with color-coded entries
- Timestamps for every event (task created, agent assigned, status changes)
- Toggle visibility with the terminal button in the header
🎯 Mission Management
- Group related tasks into missions
- Track mission progress and completion status
- Organize complex multi-task workflows
🌗 Dark & Light Mode
- Beautiful dark mode with glassmorphism effects (default)
- Clean light mode with proper contrast
- One-click toggle in the header
⚡ Real-Time Sync
- WebSocket connection to OpenClaw gateway
- Live status indicator (System Online / Offline)
- Auto-reconnection on connection loss
- Instant UI updates when agents complete work
⚙️ Setup
Prerequisites
- Node.js 18+ (download)
- OpenClaw Gateway running locally or remotely (setup guide)
Option 1: npx (Recommended)
npx openclaw-mission-controlNo installation required. The wizard handles everything.
Option 2: Clone & Run
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw/mission-control
# Install dependencies
npm install
# Configure environment
cp .env.example .env.localEdit .env.local with your settings:
# OpenClaw Gateway
OPENCLAW_GATEWAY_URL=ws://127.0.0.1:18789
OPENCLAW_AUTH_TOKEN=your_auth_token_hereStart the development server:
npm run devOpen http://localhost:3000 in your browser.
Option 3: Production Build
npm run build
npm startThe production build uses Next.js standalone output for minimal footprint and fast startup (~35ms).
🔧 Configuration
| Environment Variable | Required | Default | Description |
| ---------------------- | -------- | ---------------------- | ------------------------------------------ |
| OPENCLAW_GATEWAY_URL | No | ws://127.0.0.1:18789 | WebSocket URL of your OpenClaw gateway |
| OPENCLAW_AUTH_TOKEN | Yes | — | Auth token from your gateway's config file |
| PORT | No | 3000 | Port number for the dashboard |
Finding Your Auth Token
Your OpenClaw auth token is in your gateway configuration file (usually ~/.clawdbot/clawdbot.json):
{
"auth_token": "your_token_here"
}🏗️ Tech Stack
| Technology | Purpose | | ----------------------------------------------- | ----------------------------------------------- | | Next.js 16 | Full-stack React framework with App Router | | React 19 | UI components with React Compiler | | TypeScript 5 | Type-safe development | | Tailwind CSS 4 | Utility-first styling | | Radix UI | Accessible, unstyled UI primitives | | shadcn/ui | Pre-built component library | | SQLite | Lightweight local database (via better-sqlite3) | | dnd-kit | Drag-and-drop for Kanban board | | Lucide Icons | Beautiful icon set |
Project Structure
mission-control/
├── bin/
│ └── cli.mjs # npx entry point & setup wizard
├── src/
│ ├── app/
│ │ ├── page.tsx # Main dashboard (Kanban, Agents, Missions)
│ │ ├── globals.css # Design tokens & theme variables
│ │ └── api/
│ │ ├── tasks/ # CRUD + dispatch + comments
│ │ ├── agents/ # Agent listing from gateway
│ │ ├── missions/ # Mission management
│ │ ├── activity/ # Activity log feed
│ │ └── openclaw/ # Gateway status endpoint
│ ├── components/ # Reusable UI components (shadcn)
│ └── lib/
│ ├── db.ts # SQLite database & schema
│ └── openclaw-client.ts # WebSocket client for gateway
├── data/ # SQLite database (auto-created)
└── public/ # Static assets📚 API Reference
Mission Control exposes REST API endpoints for programmatic access:
| Method | Endpoint | Description |
| ---------- | ---------------------- | ----------------------------------------------------- |
| GET | /api/tasks | List all tasks (filterable by status, agent, mission) |
| POST | /api/tasks | Create a new task |
| PATCH | /api/tasks | Update task fields (status, priority, assignment) |
| DELETE | /api/tasks | Delete a task |
| POST | /api/tasks/dispatch | Dispatch a task to an AI agent |
| GET/POST | /api/tasks/comments | List or add task comments |
| GET | /api/agents | List connected agents from gateway |
| GET | /api/missions | List all missions |
| POST | /api/missions | Create a new mission |
| GET | /api/activity | Get recent activity log |
| GET | /api/openclaw/status | Check gateway connection status |
🤝 Contributing
Contributions are welcome! Here's how to get started:
- Fork the repository
- Clone your fork:
git clone https://github.com/your-username/openclaw.git - Create a branch:
git checkout -b feature/your-feature - Make changes and test locally
- Submit a Pull Request
Development
# Install dependencies
npm install
# Start dev server with hot-reload
npm run dev
# Run linter
npm run lint
# Production build
npm run build📄 License
This project is licensed under the MIT License.
🔗 Links
- OpenClaw Framework — The AI agent framework
- OpenClaw Website — Official website
- Report a Bug — Found an issue? Let us know
- Request a Feature — Have an idea? We'd love to hear it
