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

Go to Agents

Navigate to the Agents page in your workspace.

Initialize Cluster

Click “New OpenClaw” to start the setup.

Configure First Agent

Fill in the initial agent details:

Avatar: Upload a JPG or PNG (optional).
Emoji: Click the emoji picker next to the name.
Role: Define the agent’s specialty (e.g., “Market Researcher”).
Persona tabs: Configure IDENTITY, SOUL, USER, and TOOLS.

Add More Agents

Click ”+ Add” to include additional agents (up to 6 total). Switch between them using the tabs at the top.

Create

Click “Create Cluster” to start provisioning.

The cluster will provision in the cloud (approx. 3-5 minutes). You can monitor the progress on the Agents page.

Adding an agent to an existing cluster

Select Cluster

On the Agents page, find your cluster card.

Add Agent

Click ”+ Add” next to the agent count.

Configure

Fill in the new agent’s details and click “Add Agent to Cluster”.

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

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 correctly. If two agents have the same name, a numeric suffix is added automatically.