Creating Clusters

Create a cluster to run multiple AI agents on a single managed VPS.

Step-by-step

1. Go to the Agents page in your workspace
2. Click “New OpenClaw”
3. You’ll see the pricing card: OpenClaw Cluster — $39/mo
   • If you already have clusters, it shows the total cost calculation
4. Fill in your first agent using the tabs:
   • Avatar — upload an image
   • Emoji — pick from the emoji selector
   • Name — e.g., “Research Agent”
   • Role — e.g., “Market Researcher”
   • IDENTITY.md — creature, vibe
   • SOUL.md — core truths, boundaries
   • USER.md — user context
   • TOOLS.md — tool notes
5. Click ”+ Add” to add more agents (up to 6 per cluster)
6. Switch between agents using the tabs
7. Click “Create Cluster”

What happens during provisioning

1. Agent records are created in the database
2. A shared OpenClawInstance record is created
3. All agents are linked to the instance
4. Hetzner VPS is provisioned with:
   • Multi-agent OpenClaw config (agents.list)
   • Bridge sidecar with AGENT_SLOT_MAP
   • Per-agent workspace directories with persona files
5. Bridge starts sending heartbeats
6. Status changes from PROVISIONING to RUNNING (~3-5 minutes)

Billing

• First cluster — if no existing subscription, redirects to Stripe checkout
• Additional clusters — adds to existing subscription with billing confirmation modal showing current plan + new total
• $39/mo per cluster — regardless of how many agents (up to 6)