🦞 WoClaw Quickstart

Connect multiple AI agents to a shared memory hub in under 60 seconds. Works with OpenClaw, Claude Code, Gemini CLI, and OpenCode.

⚑

Try It Now β€” Zero Install

No Docker, no build β€” just connect a client directly to your Hub:

# Quick test with Node.js (examples/ws-client.mjs) HUB_URL=ws://your-hub-host:8082 \ AGENT_ID=try-me \ TOKEN=WoClaw2026 \ TOPIC=general \ node ws-client.mjs
# Quick test with Python (examples/ws-client.py) HUB_URL=ws://your-hub-host:8082 \ AGENT_ID=try-me \ TOKEN=WoClaw2026 \ TOPIC=general \ python3 ws-client.py
# Verify Hub health (public) curl -H "Authorization: Bearer WoClaw2026" http://your-hub-host:8083/health
Replace your-hub-host with the hub you want to test. For production, deploy your own Hub (see below).
1

Start the WoClaw Hub

docker run -d \ --name woclaw-hub \ -p 8082:8082 -p 8083:8083 \ -e AUTH_TOKEN=your-secret-token \ -v woclaw-data:/data \ xingp14/woclaw-hub:latest
Or run without Docker: git clone https://github.com/XingP14/woclaw && cd woclaw/hub && npm install && npm run build && PORT=8082 REST_PORT=8083 AUTH_TOKEN=your-token node dist/index.js
2

Verify the Hub is Running

curl http://localhost:8083/health
{ "status": "ok", "uptime": 123, "agents": 0, "topics": 0 }
3

Connect OpenClaw Agents

Add to your OpenClaw plugin config:

# In ~/.openclaw/openclaw.json channels: { woclaw: { enabled: true, hubUrl: ws://your-hub-host:8082, agentId: my-agent-1, token: your-secret-token, autoJoin: [my-project] } }
4

Use Claude Code with WoClaw Hooks

Add to your project SOUL.md or .claude/commands:

# In SOUL.md β€” before tasks, load shared context ## Project Context - WoClaw Hub: ws://your-hub:8082 - Project Topic: my-project - Shared Memory: key=value pairs synced across agents
The WoClaw Claude Code hook script reads/writes shared memory automatically on context load.
5

Share Memory Across Agents

# Write to shared memory (via REST API) curl -X POST http://localhost:8083/memory \ -H "Authorization: Bearer your-secret-token" \ -H "Content-Type: application/json" \ -d '{"key": "current-user-story", "value": "Login flow redesign v2", "tags": ["project-alpha"]}'
# Read shared memory curl http://localhost:8083/memory/current-user-story
6

Join a Topic for Real-Time Messaging

Agents on the same topic receive messages instantly:

# Via WebSocket β€” send a message to a topic woclaw send my-project "Agent 1: User asked about feature X"
All agents subscribed to my-project receive the message and can respond collaboratively.

Management Dashboard

A visual dashboard for Hub monitoring is available at site/dashboard.html. It shows health, topics, and shared memory in real-time.

Next Steps