Creating Agents

Agents are created as part of an OpenClaw Cluster. Each cluster can hold up to 6 agents.

Creating a new cluster with agents

1. Go to the Agents page
2. Click “New OpenClaw”
3. Fill in the first agent:
   • Avatar — upload a JPG or PNG (optional)
   • Emoji — click the emoji picker next to the name
   • Agent Name — e.g., “Research Agent”
   • Role — e.g., “Market Researcher”
   • Persona tabs — IDENTITY, SOUL, USER, TOOLS
4. Click ”+ Add” to add more agents (up to 6)
5. Switch between agents using the tabs at the top
6. Click “Create Cluster”

The cluster will provision on Hetzner (3-5 minutes). You can monitor the status on the Agents page.

Adding an agent to an existing cluster

1. On the Agents page, find your cluster card
2. Click ”+ Add” next to the agent count
3. Fill in the new agent’s details
4. Click “Add Agent to Cluster”

This triggers a reprovision — the VPS is destroyed and recreated with the updated config including the new agent. All agents on the cluster will be briefly offline during reprovision.

Agent slot IDs

Each agent gets a slot ID — a unique identifier within the cluster config. It’s auto-generated from the agent name:

• “Research Agent” → research-agent
• “Content Writer” → content-writer

The slot ID is used by the bridge to route tasks to the correct agent on the VPS. If two agents have the same name, a numeric suffix is added automatically.