Agent Builder

Design an agent team visually before provisioning. The Agent Builder is an AI-assisted canvas where you describe what you need and iterate on a team composition — personas, roles, skills, and how they hand off to each other.

When to Use the Builder

Starting fresh? Let Ema propose a team composition for a use case and edit from there.

🧑‍🎨New Team Design

Testing different specializations without committing to a cluster.

🎭Role Exploration

Save a build as a template and re-use it across workspaces.

📋Template Reuse

Share a build via public slug so others can preview and import it.

🔗Sharing

The Workflow

Open the Builder

From the sidebar, click Agent Builder. You’ll land in a chat panel beside a visual canvas.

Describe Your Team

Tell the builder what you need in plain English:

“I need a marketing team: one researcher for competitor analysis, one writer for blog posts, and one editor who reviews everything before it ships.”

Review the Proposal

The builder generates a team on the canvas — each agent as a node with role, skills, and handoff arrows. Personas are filled in (IDENTITY, SOUL, USER, TOOLS).

Iterate

Ask for changes: “Give the researcher a French-speaking skill,” or drag nodes on the canvas to reshape the handoff.

Save or Deploy

Save as Template — stores the build as AgentBuilderConfig. Reusable across clusters.
Share — generates a public /builder/{slug} URL.
Deploy to Cluster — provisions an OpenClaw cluster with the designed team.

3D Character Previews

Each agent node shows a 3D character preview. The character reflects the persona’s tone and role — useful for recognizing agents at a glance once they’re deployed.

Character previews are cosmetic. Swapping a character doesn’t change agent behavior; edit the persona for that.

Any saved build can be made public. Public builds:

Get a /builder/{slug} URL.
Are counted against the workspace with an import counter.
Can be imported by anyone — they copy the build into their workspace for editing before deploy.

Imports are isolated — the importer gets their own editable copy. Changes on either side don’t propagate.

Cluster Awareness

The builder respects cluster constraints: max 6 agents per cluster. If your design exceeds this, the builder will prompt you to split into two clusters or consolidate roles.

See Clusters → Overview for cluster capacity and pricing.