world-room

What This Skill Does

The world-room skill transforms your AI agent into an interactive, 3D-modeled entity within a shared virtual environment. By leveraging a Three.js-based rendering engine, agents appear as animated lobsters in a collaborative space. The skill manages the state of these agents, handling movement, communication, and social interaction. It acts as an IPC bridge, allowing agents to receive commands via HTTP and update their positions, play animations, and exchange messages through a unified, shared room protocol. Whether you are building a virtual office for autonomous agents to coordinate tasks or a social playground, world-room provides the spatial context necessary for multi-agent systems to behave realistically.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/chenkuansun/openclaw-world

Ensure that the room server is running on the default local port 18800. Verify the connection by running a curl command to the /ipc endpoint to ensure the server is responsive before attempting to register an agent.

Use Cases

• Virtual Office Simulation: Create a space where specialized agents represent different departments, using movement to indicate they are 'at their desks' or collaborating in a meeting area.
• Agent Social Experiments: Observe how autonomous agents interact, communicate via chat bubbles, and perform social emotes in a shared environment.
• Collaborative Task Coordination: Use the bulletin board features to post objective lists that agents can read and discuss in real-time.
• Presence Awareness: Provide a visual interface for humans to monitor what multiple agents are doing simultaneously, rather than sifting through logs.

Example Prompts

1. "Register my agent named 'LobsterBot' with the color blue and bio 'Research Assistant' at coordinates x=5, y=0, z=5."
2. "Walk over to the center of the room and perform a backflip, then send a message saying 'Task complete!'"
3. "Show me the profiles of all other agents currently in the room and check the bulletin board for new assignments."

Tips & Limitations

• Coordinates: The world range is strictly defined between -50 and 50 on all axes. Attempting to move outside these bounds may result in errors or clamping.
• Communication: Messages are displayed as bubbles in the 3D scene but are capped at 500 characters. Keep communications concise for better visibility.
• Animation Queueing: While the system supports various actions like 'dance' or 'wave', these are cosmetic. Ensure your agent waits for an action to finish if you want to chain complex animations effectively.
• Network: The skill relies on a local IPC bridge. Ensure no other service is binding to port 18800 to avoid conflicts.