openclaw-agent-rpg/README.md

OpenClaw Agent RPG Dashboard 👾 🏢

Ein interaktives, retro 16-Bit Pixel-Art Office-Dashboard zur visuellen Echtzeit-Überwachung von OpenClaw-Agenten, BullMQ-Queues, Gitea Pull Requests, CI/CD-Pipelines und Lead-Heartbeats.

Features

• 2.5D Pixel-Art Office Perspective:
  • Walnuss-Schreibtische mit Dual-Monitoren, Stühlen und ergonomischer Tischanordnung (Blickrichtung auf Monitore).
  • Lounge-Bereich mit Kaffeemaschine, Wasserspender, Sofa und Arcade-Automat (Flappy Bird Easter Egg).
  • Serverraum mit blinkenden Rack-LEDs und CI/CD Statusanzeige.
  • Whiteboard mit interaktivem Gitea Kanban Board (Planned, Ready, WIP, Review, Done).
• Multi-Projekt Support:
  • Nahtloses Umschalten zwischen Projekten (camper-knowledge-graph, appsoluteweb-relaunch, cinnamon-compass, mainscreen-party-framework) über das Dropdown-Menü.
  • Dynamisches Filtern der Redis/Valkey BullMQ Queues und Gitea Repositories nach projectSlug.
• Echtzeit Status & Rollout-Tracking:
  • Direkte Integration in OpenClaw Session-Rollouts (codex-home/sessions/**/rollout-*.jsonl).
  • Erkennt exakte Agenten-Zustände (WORKING, IDLE, DONE, THINKING) anhand von turn_complete und task_complete.
• Interaktive Animationen & Sound:
  • Lead-Agent delegiert Tasks visuell mit Disketten-Übergabe an Coder-Desks.
  • Party-Modus mit Konfetti bei gemergten PRs.
  • 8-Bit WebAudio Chiptune Synthesizer mit Mute-Toggle.
• Quest-Log & Retro-Terminal:
  • Anzeige aktueller Aufgaben, Git-Branch-Status und Live-Konsolenlogs am unteren Bildschirmrand.

Architektur & Start

Das Dashboard besteht aus einem leichtgewichtigen Python-Backend (server.py) und einer Vanilla HTML5/Canvas Frontend-Applikation (index.html).

Starten

# Server im Hintergrund oder Vordergrund ausführen
python3 server.py

Der Server lauscht standardmäßig auf Port 4420.

• Dashboard: http://localhost:4420/
• Live Status API: http://localhost:4420/api/status?project=<slug>