Clawctl
Guides
5 min

Build an Agent Network: Multiple OpenClaws That Talk to Each Other

Learn how to deploy multiple openclaw instances that collaborate. Build specialized agent teams for code review, research, DevOps, and more — no coding required.

Clawctl Team

Product & Engineering

Build an Agent Network: Multiple OpenClaws That Talk to Each Other

The future isn't one superintelligent agent. It's a network of specialized agents that collaborate.

Think of it like a team: a researcher who digs up information, an analyst who synthesizes it, and a writer who communicates it. Each role has different skills. Together, they accomplish more than any one could alone.

The Agent Internet Vision

Imagine agents that can call other agents. Your code reviewer agent detects a security issue and automatically pages your security-scanner agent. Your research agent finishes a literature review and hands it to your summarizer agent.

This isn't science fiction. It's what Clawctl's multi-agent feature enables today.

How Agents Find Each Other

When you create an agent with Clawctl, it's automatically registered in your agent network. Other agents can discover and communicate with it by name — no configuration needed.

# Create an agent — it's automatically registered
clawctl agents add summarizer --description "Synthesizes research"

# Now any agent can reach @summarizer by name
# No URLs, no setup — just @summarizer

The agent registry handles:

  • Discovery — Agents find each other by name
  • Routing — Messages automatically sent to the right agent
  • Health — The system knows which agents are online

This is the "agent internet" in action — specialized agents discovering and collaborating with each other.

Four Ways Agents Can Interact

1. @ Mentions

The simplest way. Just mention another agent by name in your skill instructions:

When you complete your research, mention @summarizer with your findings.
The summarizer agent will automatically receive your message and create a report.

Works just like Slack or Discord — mention an agent, they get notified.

2. AGENTS.md Handoffs

Define how your agents work together in plain English. Create an AGENTS.md file in your workspace:

# AGENTS.md

## researcher
Finds papers, data, and information.
When you finish research, hand off to @summarizer.

## summarizer
Synthesizes research findings into reports.
After receiving data, create a summary and post to #reports channel.

## code-reviewer
Reviews pull requests for bugs and security issues.
If you find security concerns, alert @security-scanner.

Each agent reads this file and knows who to contact and when.

3. CLI Messages

Send messages between agents from your terminal:

# Send a message to an agent
clawctl agents message summarizer "Please summarize the Q4 research findings"

# Send a file to an agent
clawctl agents message code-reviewer --file ./latest-pr.diff

Great for triggering workflows or testing agent handoffs.

4. Shared Workspace

Agents can communicate through files in the shared workspace:

  • Researcher writes findings to /workspace/research/findings.md
  • Summarizer watches that folder and processes new files
  • Writer picks up summaries and drafts team updates

Simple, observable, and easy to debug.

Setting Up Your Agent Network

Step 1: Create Your Agents

# List current agents
clawctl agents

# Add specialized agents
clawctl agents add researcher --description "Finds papers and data"
clawctl agents add summarizer --description "Synthesizes research"
clawctl agents add code-reviewer --description "Reviews PRs for bugs"

Step 2: Define Handoffs

Create an AGENTS.md file that describes how agents should collaborate:

## researcher
When research is complete, hand off to @summarizer.

## summarizer
After summarizing, notify the team via @writer.

Step 3: Connect Channels

Each agent can have different channels. Maybe your researcher lives in Slack, your code-reviewer monitors GitHub, and your summarizer posts to Discord.

Use Case: Code Review Pipeline

One of the most powerful multi-agent setups is the code review pipeline:

  1. PR Agent receives a pull request notification
  2. Mentions @security-scanner to check for vulnerabilities
  3. If clean, mentions @docs-updater to regenerate documentation
  4. Reports results back to GitHub

All while you sleep. All with full audit trails.

PR submitted → PR Agent → @security-scanner → @docs-updater → Merged
                   ↓              ↓                 ↓
              [audit log]   [audit log]       [audit log]

Use Case: Research Team

Set up a research workflow:

  1. Researcher monitors arXiv for papers in your domain
  2. Hands promising papers to @analyst for deeper review
  3. Analyst sends summaries to @writer for team updates
  4. Writer posts to your team's Slack channel

Each agent focuses on what it does best. Handoffs happen automatically.

Security: Every Agent Has an Audit Trail

When agents communicate, the system tracks:

  • Which agent initiated the action
  • What message was sent
  • What the result was
  • Timestamps for everything

High-risk actions still require approval, regardless of which agent initiates them. You maintain control even as automation increases.

Plan Limits

PlanAgents
Starter1
Team5
Business25
EnterpriseCustom

Most teams start with Team plan (5 agents) — enough for a solid code review pipeline or research team.

Getting Started

  1. Upgrade to Team if you're on Starter: clawctl upgrade team
  2. Create your agents: clawctl agents add {name}
  3. Define handoffs in your AGENTS.md file
  4. Watch the magic as your agents collaborate

The Future is Collaborative

Single agents hit limits. They context switch, they forget, they get overwhelmed.

Agent networks scale. Each agent stays focused. Handoffs are explicit. Audit trails are clear.

Start building your agent network today.


Deploy your first multi-agent setup — Team plan includes 5 agents.

Inspired by the vision of an "agent internet" — specialized agents collaborating across networks.

Ready to deploy your OpenClaw securely?

Get your OpenClaw running in production with Clawctl's enterprise-grade security.