QuantumOS

---

name: quantumos description: Install and manage QuantumOS, an AI command center dashboard for OpenClaw. Use when the user wants to set up QuantumOS, start/stop the dashboard, troubleshoot it, or update it. Provides a real-time chat UI, Mission Control (kanban task management with AI agents), and a feed dashboard (Reddit, HN, X, news).

---

QuantumOS

AI command center dashboard for OpenClaw. Next.js app that connects to the gateway via WebSocket.

Install

Run the setup script, then configure agent integration. Both steps are required.

Step 1: Run setup

bash "SKILL_DIR/scripts/setup.sh"

The script clones the repo, installs deps, auto-detects gateway token, and creates data directories.

If the user doesn't have Node.js 20+, tell them to install it first: https://nodejs.org

Step 2: Configure agent integration

After setup, you MUST add Mission Control triage to your workspace's HEARTBEAT.md. Append the following block (do not overwrite existing content):

## Check for new Mission Control tasks
GET http://localhost:3005/api/mission-control/tasks
Look for tasks with status "inbox"
For each inbox task: generate a proper title, set status to "in_progress", and start working on it
After completing a task: add a comment documenting what was done, set status to "done"

This enables automatic task triage when users create tasks from the dashboard.

Start

cd ~/Projects/quantumos && npm run dev

Dashboard will be at http://localhost:3005

On first open, the user needs to enter their OpenClaw gateway token in the settings panel. They can find it in ~/.openclaw/openclaw.json under gateway.token.

Stop

Kill the dev server process (Ctrl+C in the terminal running it).

For background operation:

cd ~/Projects/quantumos && nohup npm run dev > /tmp/quantumos.log 2>&1 &

Update

cd ~/Projects/quantumos && git pull && npm install

Then restart the dev server.

Troubleshooting

Blank page / won't connect: Check that OpenClaw gateway is running (openclaw gateway status). Verify the gateway token in dashboard settings matches ~/.openclaw/openclaw.json.

Port conflict: Change port in package.json scripts.dev (--port 3005).

Feeds not loading: Run python3 scripts/fetch-dashboard-feeds.py from the quantumos directory. Requires Python 3.8+.

API Keys

X/Twitter feeds require an xAI API key. Get one at console.x.ai. Add XAI_API_KEY=your-key to .env.local or set it as an environment variable. Without it, X feeds are gracefully skipped.

Features Overview

Chat: Real-time WebSocket chat with the OpenClaw gateway, streaming responses, thinking blocks, tool call display

Mission Control: Kanban board with task creation, agent assignment, comments, status tracking

Dashboard: Aggregated feeds from Reddit, Hacker News, X, and news with archiving

Agent Settings: Configure agents, models, tools directly from the UI

Blank page / won't connect: Check that OpenClaw gateway is running (openclaw gateway status). Verify the gateway token in dashboard settings matches ~/.openclaw/openclaw.json.

Port conflict: Change port in package.json scripts.dev (--port 3005).

Feeds not loading: Run python3 scripts/fetch-dashboard-feeds.py from the quantumos directory. Requires Python 3.8+.