Your agents are running.
Can you see them?

Agent World turns your OpenClaw sessions into a real-time pixel art control room. See every agent. Know every state.

# Install the plugin

openclaw plugins install @spicyclaws/openclaw-agentworld

# Enable it

openclaw plugins enable openclaw-agentworld

# Restart the gateway

openclaw gateway restart

6 diverse agents included

Agent World office — agents sitting at desks, walking, working in a pixel art office

Built for Agent Operators

Everything you need to observe and manage your AI agent fleet.

⚡

One-Command Install

Three commands. No config files. Production-ready in 30 seconds.

◎

Auto-Follow Sessions

Automatically tracks your active session. No more wrong-session bugs.

◈

Connection State

See connection status at a glance. Mismatch warnings with one-click switch.

⬡

Smart Mirroring

Deduped, reliable agent mirroring. No phantom duplicates.

▣

Real-Time Tracking

Watch agents type, read, and execute — animated live in pixel art.

⬢

Sub-Agent Chains

Task tool sub-agents spawn as linked characters. See the full chain.

Install in 30 seconds

Three commands. That's it.

# Install the plugin

openclaw plugins install @spicyclaws/openclaw-agentworld

# Enable it

openclaw plugins enable openclaw-agentworld

# Restart the gateway

openclaw gateway restart

Your agents are now visible.

@spicyclaws/openclaw-agentworld on npm →

Verify It Works

Three quick checks to confirm everything is running.

Check plugin status

openclaw plugins list

Check gateway

openclaw gateway status

Open AgentWorld

Navigate to Control UI → AgentWorld tab

Agent World office running successfully with connected agents

Common Issues

Quick fixes for the most common problems.

Ensure you ran openclaw gateway restart after enabling the plugin. Then verify the plugin is active with openclaw plugins list — it should show openclaw-agentworld as enabled.

Agent World auto-follows your active session. If you see a mismatch warning, click the session indicator in the status bar to manually switch. The warning means the UI is showing a different session than the one currently running.

The mirror system deduplicates automatically, but stale state can sometimes cause duplicates. Run openclaw gateway restart to clear the state. If duplicates persist, check that you don't have multiple gateway instances running.

Run openclaw gateway status to verify the gateway is running. Check your network connection to the gateway host. If running locally, ensure the gateway process hasn't crashed — restart it with openclaw gateway restart.

Questions

Is Agent World free?

Yes. MIT licensed, fully open source. No paid tiers, no feature gating.

What's the performance impact?

Zero. Agent World is purely observational — it watches agent activity, never interferes with execution.

Can I customize the office?

Full layout editor included — floors, walls, furniture, colors. Export and share layouts as JSON.

Does it work with sub-agents?

Yes. Task tool sub-agents spawn as linked characters with visual parent connections and shared palettes.

Where is state stored?

Layout and seat assignments persist in your OpenClaw instance. No external dependencies or cloud sync.

Can I use it without OpenClaw?

The VS Code extension works standalone. This plugin is specifically for OpenClaw gateway integration.

Your agents are running.Can you see them?