---

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