Installation

Get Agent World running

Agent World requires Python 3.10+ and an active OpenClaw installation.

One-line install

curl -fsSL https://agent-world.dev/install.sh | sh

This clones the repository, installs dependencies, and prints the command to start the server.

Manual install

1

Clone the repository

git clone https://github.com/luccathescientist/agent_world
cd agent_world
2

Install Python dependencies

pip install -r requirements.txt

Dependencies: fastapi, uvicorn, python-multipart.

3

Start the server

python server.py --port 8890

Then open http://localhost:8890.

4

Connect to OpenClaw

Agent World reads session data from your OpenClaw home directory (default: ~/.openclaw). Override it via environment variable:

OPENCLAW_HOME=/path/to/.openclaw python server.py --port 8890

Smoke test

  • ✓The world renders without missing static assets
  • ✓The default office layout is visible
  • ✓An agent can be selected and the inspector populates
  • ✓The chat panel shows agent history

Voice support

Voice input/output requires Node.js and a valid OpenClaw workspace with tsx installed. Set OPENCLAW_WORKSPACE or place an OpenClaw checkout at ../openclaw relative to the Agent World directory.