Documentation Index
Fetch the complete documentation index at: https://docs.clawup.org/llms.txt
Use this file to discover all available pages before exploring further.
Teams let you create multi-agent groups that work together. Each team member is a Claw with a specific role and persona. Instead of manually creating individual Claws and wiring them together, Teams automates the entire setup.
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:
Research AI safety trends and compile a report.
You → Leader: "Research AI safety trends"
Leader thinks as Researcher 1: gathers findings on academic papers
Leader thinks as Researcher 2: gathers findings on industry practices
Leader thinks as Writer: compiles findings into a report
Leader → You: "Report complete: ..."
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 |
Use remote_spawn to send research tasks to both researchers in parallel:
- abc-research-1: Research academic AI safety papers from 2024-2025
- abc-research-2: Research industry AI safety practices and standards
Then wait for both results and ask abc-writer to compile them into a report.
You → Leader: "Research AI safety trends"
Leader → Researcher 1: remote_spawn("Research recent AI safety papers")
Leader → Researcher 2: remote_spawn("Research industry AI safety practices")
Researcher 1 → Leader: task completed with findings
Researcher 2 → Leader: task completed with findings
Leader → Writer: remote_spawn("Compile these findings into a report")
Writer → Leader: task completed with report
Leader → You: "Report complete: ..."
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.
Make sure your account has sufficient balance before creating a team.
