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:
CODEBLOCK0
⚠️ 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)
CODEBLOCK2
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_fds on 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.exe argument 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
main session by default
⚠️ Command Reference
| Command | What it does |
|---|
| INLINECODE14 | Prints the SOP block for manual copy-paste into AGENTS.md |
| INLINECODE15 |
Sends a message to another agent |
Note: There is NO install subcommand. Use setup to generate the SOP.
Requirements
- - OpenClaw >= 2026.x
- Python 3.x
Created for the OpenClaw / ClawDBot community.多智能体对讲机
🗣️ 一款为OpenClaw设计的强大、安全且零侵入的点对点通信技能。
该技能使独立的OpenClaw智能体（例如 zz、dev、rc）能够在隔离的工作空间之间安全地发送消息并相互唤醒。它充当多智能体设置的异步对讲系统。
🚀 快速启动指南
1. 初始化（首次设置 — 一次性手动步骤）
运行设置脚本以生成通信协议SOP：
bash
python /scripts/intercom.py setup
⚠️ 重要提示： 该脚本会将SOP块打印到屏幕上——它不会自动写入任何文件。您必须手动复制打印的SOP块，并将其粘贴到每个智能体的AGENTS.md文件底部。 粘贴后，在聊天中输入/new以重新加载它们的知识库。
2. 发送消息
确定目标智能体的ID和您自己的ID，然后运行：
bash
python DIR>/scripts/intercom.py send AGENTID> AGENTID> MESSAGE>
注意：此脚本在后台异步运行。它将立即返回。请勿等待或重试。
3. 示例（您是zz，告诉dev更新头像）
bash
python /scripts/intercom.py send dev zz 嗨 dev，老板希望我们今天更新头像。完成后请确认。
当dev收到此消息时，消息将格式化为[来自智能体 zz] 嗨 dev，老板希望我们今天更新头像...——嵌入在AGENTS.md中的SOP会准确告诉dev如何响应。
🌟 为什么需要这个？
根据设计，OpenClaw智能体在隔离的数据库和沙箱中运行。内置的sessionssend工具只能在其自身的子智能体层级内发送消息。如果智能体A尝试使用sessionssend向智能体B发送消息，将会导致会话未找到错误。
多智能体对讲机通过利用原生的openclaw agent CLI机制来解决这个问题，安全地桥接这些隔离的环境，使智能体能够在去中心化的公司中作为平等的对等体运行。
🛡️ 安全第一：零侵入 & 100%合规
- - 无文件篡改：不会自动修改或重写任何系统文件。您始终拥有完全控制权。
- 无Shell注入：安全的子进程参数列表防止RCE漏洞。
- 真正静默执行：在Windows上使用CREATENOWINDOW + close_fds实现零控制台弹窗。
- 防循环中断器：协议防止无限的收到→感谢循环。
✨ 功能特性
- - 跨边界消息传递 — 可到达同一系统上的任何智能体
- 强大的多行支持 — 通过PowerShell路由绕过Windows cmd.exe参数截断
- 国际化（i18n） — 自动检测操作系统语言（英语/中文）
- 即时唤醒 — 绕过休眠状态，强制目标立即处理
- 持久上下文 — 默认定位到main会话
⚠️ 命令参考
| 命令 | 功能说明 |
|---|
| python intercom.py setup | 打印SOP块，供手动复制粘贴到AGENTS.md |
| python intercom.py send <target> <sender> <msg> |
向另一个智能体发送消息 |
注意： 没有install子命令。请使用setup生成SOP。
系统要求
- - OpenClaw >= 2026.x
- Python 3.x
为OpenClaw / ClawDBot社区创建。
