mission-control/skills/mission-control-installer/README.md

Mission Control Installer Skill

Install and configure Mission Control on any Linux or macOS system.

What This Skill Does

1. Detects the target OS and available runtimes (Docker or Node.js 20+)
2. Clones or updates the Mission Control repository
3. Generates a secure .env with random credentials
4. Starts the dashboard via Docker Compose or local Node.js
5. Runs an OpenClaw fleet health check (cleans stale PIDs, old logs, validates gateway)
6. Prints the access URL and admin credentials

Usage

Run the installer script:

# Auto-detect deployment mode (prefers Docker)
bash install.sh

# Force Docker deployment
bash install.sh --docker

# Force local deployment (Node.js + pnpm)
bash install.sh --local

# Custom port
bash install.sh --port 8080

# Skip OpenClaw fleet check
bash install.sh --skip-openclaw

Or as a one-liner:

curl -fsSL https://raw.githubusercontent.com/builderz-labs/mission-control/main/install.sh | bash

Prerequisites

• Docker mode: Docker Engine with Docker Compose v2
• Local mode: Node.js 20+, pnpm (auto-installed via corepack if missing)
• Both: git (to clone the repository)

Post-Install

After installation:

1. Open http://localhost:3000 (or your configured port)
2. Log in with the credentials printed by the installer (also in .env)
3. Configure your OpenClaw gateway connection in Settings
4. Register agents via the Agents panel

Environment Configuration

The installer generates a .env from .env.example with secure random values for:

• AUTH_PASS — 24-character random password
• API_KEY — 32-character hex API key
• AUTH_SECRET — 32-character session secret

To regenerate credentials independently:

bash scripts/generate-env.sh --force