Agency HQ — AI Agent Office#

A real-time pixel art visualization of your AI agent team. Agents move between rooms (office, kitchen, game room, server room) based on their actual status. Includes a live activity feed, agent spotlight cards, and personality-driven chat.

When to Use#

• You want a visual dashboard showing what your agents are doing
• You want to showcase your agent team to others (demo mode)
• You want a fun, always-on display of your OpenClaw setup

Setup#

1. Clone and Install#

bash

git clone https://github.com/enjinstudio/agency-hq.git
cd agency-hq
npm install

2. Configure Mode#

Copy .env.example to .env.local:

bash

cp .env.example .env.local

Set ARENA_MODE=live to connect to your OpenClaw instance, or leave as demo for simulated data.

3. Customize Your Agents#

Edit src/lib/agents.ts. Each agent needs:

FieldDescriptionidMust match your OpenClaw agent ID (e.g., main, dev, research)nameDisplay nameemojiAvatar emojiroleRole label shown in spotlightmodelModel name shown in spotlightcolorHex color for theme and pixel artdeskDesk position: command, dev, trading, research, design, security, content, strategy, engineering, pm, finance``accessoryPixel art accessory: glasses, hat, badge, headphones, scarf, cap, bowtie, visor, antenna, crown, monocle

4. Customize Chat Lines (Optional)#

Edit src/lib/agent-chat.ts to write personality-driven banter. Each agent has:

• general — random lines said to the room
• to{AgentName} — directed lines at specific agents (30% chance)

5. Run#

bash

# Development
npm run dev

# Production
npm run build && npm start

6. Deploy to Vercel (Optional)#

Push to GitHub and import in Vercel. Demo mode activates automatically on Vercel.

How Live Mode Works#

In live mode, the app reads from your OpenClaw directory:

• Agent status — scans ~/.openclaw/agents/{id}/sessions/*.jsonl for recent activity
• Activity feed — extracts user messages and tool calls from session files
• System stats — reads /proc/loadavg, runs free -m and df
• Room assignment — active agents → office, idle → kitchen/game room, offline → rest room

No database. No external APIs. Just reads files from disk.

Requirements#

• Node.js 20+
• OpenClaw (for live mode only)
• npm

Notes#

• The chat system generates fun flavor text — it's not real agent communication
• Demo mode works everywhere, including Vercel, with zero configuration
• The pixel art renderer uses Canvas2D — no WebGL required, works in all browsers
• Mobile responsive — stacks vertically on small screens