RTS Dashboard

A StarCraft/C&C-inspired tactical command center for OpenClaw monitoring.

Agent Actions

Start Dashboard

When the user wants to open/view/launch the dashboard, or when visiting 127.0.0.1:4320 fails:

1. 1. Check if already running:

   Get-NetTCPConnection -LocalPort 4320 -ErrorAction SilentlyContinue
   

1. 2. If not running, start it in background:

   cd "<skill_dir>"; node server.js
   

1. 3. If node_modules/ is missing, run npm install first.
2. Tell the user: http://127.0.0.1:4320 is ready.

Stop Dashboard

CODEBLOCK2

Quick Start (Manual)

CODEBLOCK3

Open http://127.0.0.1:4320 in browser.

Requirements

• - Node.js 18+
• OpenClaw Gateway running (default port 18789)
• INLINECODE9 npm package (auto-installed via npm install)

Features

• - Tactical map: Active agents as diamond nodes with orbiting skill dots and trail animation
• Left panel: Full agent list + skill library with search
• Right panel: System vitals (CPU/RAM), gateway status, event logs, selected target details
• Agent detail: Model, current task, deployed skills, recent conversation
• Skill detail: Description, use cases, related agents
• Chat bar: Send messages to agents via Gateway WebSocket chat.send RPC
• Cron jobs: Display scheduled tasks with status on the map
• 5-min cooldown: Agents remain visible for 5 minutes after going offline (amber blink + countdown)
• CRT scan line + radar sweep + grid: Full military-UI aesthetic

Configuration

Environment variables (all optional):

Authentication

The dashboard implements Ed25519 device signing for Gateway WebSocket authentication:

• - On first launch, generates a keypair and saves to INLINECODE19
• Signs each connect.challenge nonce using v3 protocol
• Gateway token is auto-discovered from OPENCLAW_GATEWAY_TOKEN env var or gateway.auth.token in INLINECODE23
• Localhost connections are auto-approved by Gateway (no manual pairing needed)
• No dangerouslyDisableDeviceAuth or allowInsecureAuth required

Cross-Platform

• - OpenClaw installation path auto-detected via require.resolve → which/where → npm root -g → fallback paths
• Skill directories: ~/.agents/skills/ (user) + {openclaw}/skills/ (built-in) + {openclaw}/extensions/*/skills/ (extensions)
• Agent/skill config parsed via JSON.parse (robust, no regex)
• Works on Windows, macOS, and Linux

Gateway Requirements

The dashboard needs the Gateway to allow its WebSocket origin:

CODEBLOCK4

This is the only Gateway config change needed. Apply with openclaw config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:4320"]' or via the Control UI config panel.

Data Sources (refreshed every 3 seconds)

• - Agents: ~/.openclaw/openclaw.json → INLINECODE35
• Skills: Filesystem scan of skill directories
• Active sessions: .jsonl.lock files in INLINECODE37
• System vitals: Node.js os module (CPU delta sampling every 2s)
• Gateway status: HTTP GET to gateway root
• Cron jobs: INLINECODE39

File Structure

CODEBLOCK5