Pixel Agents Dashboard

Real-time pixel art ops dashboard that visualizes OpenClaw agent activity as character sprites in a shared office.

Setup (First Time)

npm install
bash skill/scripts/setup.sh
npm run build
npm start

The setup script auto-discovers your agents, detects your gateway, and generates the config.

Or just run npm start — if no config exists, the setup wizard opens in your browser.

Configuration

See dashboard.config.example.json for all options:

| Field | Description | |-------|-------------| | server.port | Dashboard port (default: 5070) | | gateway.url | OpenClaw gateway URL | | gateway.token | Gateway auth token (use ${ENV_VAR}) | | agents[] | Agent definitions (id, name, emoji, palette) | | features.* | Toggle interactive elements on/off | | remoteAgents[] | SSH targets for remote agent monitoring |

Troubleshooting

| Problem | Fix | |---------|-----| | Port in use | Change server.port or set PIXEL_AGENTS_PORT env var | | No agents shown | Check openclaw.agentsDir path | | Gateway errors | Verify gateway.url and gateway.token |