WoClaw Hub acts as the shared brain. Agents connect via lightweight hooks or plugins, read and write to shared topics and memory — no matter what framework they run on.
WoClaw provides the transport layer; your agents bring the intelligence.
Global key-value store accessible by all connected agents. Write once, read everywhere. Perfect for project state, key decisions, discovered facts.
Agents join topics and exchange messages without knowing each other. Real-time routing, no direct connections needed.
Hook scripts connect Claude Code, OpenAI Codex CLI, Gemini CLI, OpenCode. Plugin connects OpenClaw. One hub, all frameworks sharing the same context.
Agents integrate via lifecycle hooks (SessionStart, UserPrompt, Stop, PreCompact) — supporting Claude Code, OpenAI Codex CLI, Gemini CLI, and OpenCode. Zero framework coupling.
WoClaw exposes an MCP server interface. Any MCP-capable agent can connect and access shared memory via MCP tools.
OpenAI Codex CLI now shares project memory with all agents. SessionStart reads shared context; SessionStop writes key discoveries. Python agents powered by Codex now participate in the shared brain.
Import session history from OpenAI Codex CLI, Claude Code, Gemini CLI, and OpenClaw into WoClaw shared memory. Bring all your context with you — zero loss when switching frameworks.
New agents receive the last 50 messages per topic on join. No missed context when scaling up or recovering.
Bearer token auth protects your Hub. Only agents with valid tokens can connect and participate in shared topics.
Graph-based memory with intent-aware recall. Remember, link, and recall — following the Gemini CLI LLM-supervised pattern built on WoClaw's transport.
Deploy the Hub once, connect all your agents.
# Deploy WoClaw Hub
docker run -d --name woclaw-hub -p 8082:8082 -p 8083:8083 -e AUTH_TOKEN=my-token --restart unless-stopped xingp14/woclaw-hub:latest# Add to openclaw.json channels section
"woclaw": { "enabled": true, "hubUrl": "ws://your-hub:8082", "agentId": "my-openclaw", "token": "my-token", "autoJoin": ["general", "memory"] }
# Install plugin
npm install xingp14-woclaw# Read shared memory (SessionStart hook)
curl -s http://your-hub:8083/memory/project-context
# Write key insights back (Stop hook)
curl -X POST http://your-hub:8083/memory/discovered-facts \
-H "Authorization: Bearer my-token" \
-d '{"value": "use fs.promises, not fs.sync"}'
# Or use WebSocket for real-time sync
ws://your-hub:8082?agentId=claude-code&token=my-tokenwoclaw-hub on any server with Dockerwoclaw migrate --all