Skill: murtiurti4/quantumos (version 0.2.0)

--- 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 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 ```bash 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: ```bash cd ~/Projects/quantumos && nohup npm run dev > /tmp/quantumos.log 2>&1 & ``` ## Update ```bash 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](https://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

path: scripts/setup.sh
content: #!/bin/bash
set -e

# QuantumOS Setup Script
# Installs and configures QuantumOS dashboard for OpenClaw

REPO="https://github.com/murtiurti4/quantumos.git"
INSTALL_DIR="$HOME/Projects/quantumos"
MC_DIR="$HOME/.openclaw/mission-control"
DASH_DIR="$HOME/.openclaw/dashboard-data"
OC_CONFIG="$HOME/.openclaw/openclaw.json"

echo ""
echo "  ╔═══════════════════════════════════╗"
echo "  ║        QuantumOS Setup            ║"
echo "  ╚═══════════════════════════════════╝"
echo ""

# Check Node.js
if ! command -v node &> /dev/null; then
    echo "❌ Node.js not found. Install Node.js 20+ from https://nodejs.org"
    exit 1
fi

NODE_VER=$(node -v | sed 's/v//' | cut -d. -f1)
if [ "$NODE_VER" -lt 20 ]; then
    echo "❌ Node.js 20+ required (found v$(node -v)). Update from https://nodejs.org"
    exit 1
fi
echo "✅ Node.js $(node -v)"

# Check git
if ! command -v git &> /dev/null; then
    echo "❌ Git not found. Install git first."
    exit 1
fi
echo "✅ Git found"

# Clone or update repo
if [ -d "$INSTALL_DIR" ]; then
    echo "📁 QuantumOS already exists at $INSTALL_DIR"
    cd "$INSTALL_DIR"
    echo "   Pulling latest..."
    git pull --ff-only 2>/dev/null || echo "   (skipped pull - may have local changes)"
else
    echo "📥 Cloning QuantumOS..."
    mkdir -p "$(dirname "$INSTALL_DIR")"
    git clone "$REPO" "$INSTALL_DIR"
    cd "$INSTALL_DIR"
fi

# Install dependencies
echo "📦 Installing dependencies..."
npm install --no-audit --no-fund 2>&1 | tail -1

# Create data directories
mkdir -p "$MC_DIR" "$DASH_DIR"
echo "📁 Data directories ready"

# Create .env.local if missing
if [ ! -f .env.local ]; then
    echo "⚙️  Setting up environment..."

    # Try to auto-detect gateway token
    GW_TOKEN=""
    GW_PORT="18789"
    if [ -f "$OC_CONFIG" ]; then
        GW_TOKEN=$(python3 -c "import json; c=json.load(open('$OC_CONFIG')); print(c.get('gateway',{}).get('token',''))" 2>/dev/null || echo "")
        GW_PORT_FOUND=$(python3 -c "import json; c=json.load(open('$OC_CONFIG')); print(c.get('gateway',{}).get('port',''))" 2>/dev/null || echo "")
        if [ -n "$GW_PORT_FOUND" ]; then
            GW_PORT="$GW_PORT_FOUND"
        fi
    fi

    if [ -z "$GW_TOKEN" ]; then
        echo ""
        echo "   Couldn't auto-detect gateway token."
        echo "   Find it in: ~/.openclaw/openclaw.json → gateway.token"
        echo ""
        read -p "   Enter your OpenClaw gateway token: " GW_TOKEN
    else
        echo "   ✅ Auto-detected gateway token"
    fi

    cat > .env.local << EOF
OPENCLAW_GATEWAY_PORT=$GW_PORT
OPENCLAW_GATEWAY_TOKEN=$GW_TOKEN
EOF
    echo "   ✅ Created .env.local"
else
    echo "⚙️  .env.local already exists (keeping existing)"
fi

# Initialize empty data files if needed
if [ ! -f "$MC_DIR/tasks.json" ]; then
    echo '[]' > "$MC_DIR/tasks.json"
fi
if [ ! -f "$MC_DIR/agents.json" ]; then
    echo '[]' > "$MC_DIR/agents.json"
fi
if [ ! -f "$MC_DIR/activities.json" ]; then
    echo '[]' > "$MC_DIR/activities.json"
fi
if [ ! -f "$MC_DIR/notifications.json" ]; then
    echo '[]' > "$MC_DIR/notifications.json"
fi

echo ""
echo "  ✅ QuantumOS is ready!"
echo ""
echo "  To start:"
echo "    cd $INSTALL_DIR"
echo "    npm run dev"
echo ""
echo "  Then open: http://localhost:3005"
echo ""
echo "  On first open, enter your gateway token in Settings."
echo "  (It's in ~/.openclaw/openclaw.json → gateway.token)"
echo ""


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (CRITICAL)