Communication Modes
When creating a team, you choose how members communicate:| Mode | Containers | Communication | Best for |
|---|---|---|---|
| SubAgent (recommended) | 1 (leader only) | sessions_spawn / sessions_send — built-in Hermes Agent sessions | Fast responses, low cost, most use cases |
| MultiAgent | N (one per member) | remote_send / remote_spawn via Claw Connect MCP | Different models per role, cross-team networking, multi-user collaboration |
SubAgent Mode
In SubAgent mode, the leader bot runs a single container. Team members exist as virtual personas within the leader’s prompt. The leader role-plays each member inline — analyzing the task, thinking from each member’s perspective, and synthesizing the results. This is faster and cheaper because everything happens in a single context window with no network overhead or tool calls.MultiAgent Mode
In MultiAgent mode, each team member is a separate container with its own model and API key. Members communicate through Claw Connect MCP tools over the network. This mode supports different models per role (e.g., GPT-5.4 for the leader, Claude Haiku 4.5 for researchers), cross-team communication via Nebula, and multi-user collaboration — multiple people can interact with different team members simultaneously through their own messaging channels.Creating a Team
Go to Teams in the left sidebar and click Create Team.Step 1: Name and Mode
- Enter a Team Name (e.g., “My Research Team”)
- Choose Communication Mode — SubAgent (recommended) or MultiAgent
- Select a Model and enter your API Key
Step 2: Choose Configuration Method
You can build your team from a Template or use AI Generate.From Template
Choose one of the four built-in templates:| Template | Roles | Workflow |
|---|---|---|
| Research Team | Leader, 2 Researchers, Writer | Leader assigns research tasks, researchers gather findings, writer compiles the report |
| Software Company (MetaGPT) | PM, Architect, Engineer, QA | PM defines requirements, architect designs, engineer implements, QA validates |
| Data Analysis Team | Leader, Analyst, Searcher, Reporter | Leader coordinates, analyst processes data, searcher gathers sources, reporter writes output |
| Investment Analysis | Analyst, Risk Assessor, Strategist, Advisor | Analyst reviews data, risk assessor evaluates risks, strategist plans, advisor gives recommendations |
AI Generate
- Switch the configuration mode to AI Generate
- Describe what you need in one sentence (e.g., “Help me analyze the crypto market”)
- Click Generate — the AI creates team roles and personas automatically
- Review and edit the generated configuration before proceeding
Step 3: Review Roles and Personas
After selecting a template or generating roles, you can review and edit each team member’s persona. Each role has a name, description, and system prompt that defines how it behaves.Step 4: Leader and Channels (Optional)
Select a Leader for the team. The leader is the member you interact with directly — it coordinates the other members. You can also configure a messaging channel (Telegram, Feishu) for the leader so you can chat with the team from your preferred platform.Step 5: Create
Click Create Team. In SubAgent mode, one container is provisioned with a composite prompt. In MultiAgent mode, all members are provisioned as separate containers with Claw Connect networking. This typically takes 1-3 minutes.Team Operations
Once a team is created, you can manage it from the Teams page:- Stop — Pauses all team members at once
- Start — Resumes a stopped team
- Delete — Removes the team and all its members
- Quick Chat — Send messages directly to the team leader from the console
How Teams Communicate
SubAgent Mode (inline personas)
In SubAgent mode, the leader handles all team member perspectives within a single conversation turn. No tools or sessions are needed — the leader role-plays each member inline. Example prompt:MultiAgent Mode (Claw Connect)
In MultiAgent mode, team members communicate through Claw Connect MCP tools over the network. Each member is a separate container.| Tool | What it does | When to use |
|---|---|---|
remote_send | Send a message and get a direct reply | Quick questions, short instructions |
remote_spawn | Delegate a background task (returns immediately) | Long-running research, parallel work |
get_task_result | Check the result of a spawned task | Poll for completion |
list_peers | List all online team members | Check who’s available |
Tip: For more details on MultiAgent communication tools, see the Claw Connect documentation.
Session Persistence
Team conversations persist across restarts. If a team is stopped and restarted, the session history is preserved so the team can pick up where it left off.Billing
- SubAgent mode — Only 1 container is billed (the leader). A 4-member team costs 1 x $10/month on the Basic plan.
- MultiAgent mode — Each member is a separate container. A 4-member team costs 4 x $10/month = $40/month on the Basic plan.