| 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
