Multi-Agent Intercom
🗣️ A powerful, secure, and zero-intrusive peer-to-peer communication skill for OpenClaw.
This skill enables independent OpenClaw agents (e.g., zz, dev, rc) to securely send messages and wake up each other across isolated workspaces. It acts as an asynchronous "intercom system" for your Multi-Agent setup.
🚀 Quick-Start Instructions
1. Initialization (First Time Setup — One-Time Manual Step)
Run the setup script to generate the communication protocol SOP:
python <SKILL_DIR>/scripts/intercom.py setup
⚠️ Important: The script will print an SOP block to the screen — it does NOT auto-write any files. You must manually copy the printed SOP block and paste it at the bottom of each agent's AGENTS.md file. After pasting, type /new in your chat to reload their brains.
2. Send a Message
Determine the target agent's ID and your own ID, then run:
python <SKILL_DIR>/scripts/intercom.py send <TARGET_AGENT_ID> <YOUR_AGENT_ID> "<YOUR_MESSAGE>"
Note: This script runs asynchronously in the background. It will return immediately. Do not wait or retry.
3. Example (You are 'zz', telling 'dev' to update avatars)
python <SKILL_DIR>/scripts/intercom.py send dev zz "Hi dev, the Boss wants us to update our avatars today. Acknowledge when done."
When 'dev' receives this, the message will be formatted as [From Agent zz] Hi dev, the Boss wants us to update our avatars today... — the SOP embedded in AGENTS.md tells 'dev' exactly how to respond.
🌟 Why is this needed?
By design, OpenClaw agents run in isolated databases and sandboxes. The built-in sessions_send tool can only send messages within an agent's own subagent hierarchy. If Agent A tries to use sessions_send to message Agent B, it will result in a "Session not found" error.
Multi-Agent Intercom solves this by leveraging the native openclaw agent CLI mechanism to safely bridge these isolated environments, allowing agents to act as equal peers in a decentralized company.
🛡️ Security First: Zero-Intrusive & 100% Compliant
- No File Tampering: Does NOT automatically modify or rewrite any system files. You remain in full control.
- No Shell Injection: Safe subprocess argument lists prevent RCE vulnerabilities.
- True Silent Execution: Uses
CREATE_NO_WINDOW+close_fdson Windows for zero console popups. - Anti-Loop Breaker: The protocol prevents infinite "Received → Thank you" loops.
✨ Features
- Cross-Boundary Messaging — reach any agent on the same system
- Robust Multiline Support — bypasses Windows
cmd.exeargument truncation via PowerShell routing - Internationalization (i18n) — auto-detects OS language (English / Chinese)
- Immediate Wake-up — bypasses sleep states, forces target to process now
- Persistent Context — targets the
mainsession by default
⚠️ Command Reference
| Command | What it does |
|---|---|
python intercom.py setup | Prints the SOP block for manual copy-paste into AGENTS.md |
python intercom.py send <target> <sender> "<msg>" | Sends a message to another agent |
Note: There is NO
installsubcommand. Usesetupto generate the SOP.
Requirements
- OpenClaw >= 2026.x
- Python 3.x
Created for the OpenClaw / ClawDBot community.