核心用法
Multi-Agent Intercom 是一款专为 OpenClaw 生态设计的代理间通信桥梁技能,解决 sessions_send 无法跨代理边界的核心限制。通过 Python 脚本实现点对点消息投递,支持异步唤醒机制,让独立工作空间的代理(如 zz、dev、rc)能够安全协同。
初始化流程(首次使用必执行):
1. 运行 python <SKILL_DIR>/scripts/intercom.py setup 生成标准操作程序(SOP)
2. 将生成的 SOP 文本手动复制到系统中所有代理的 AGENTS.md 文件
3. 执行 /new 重启各代理以加载协议
发送消息:
python <SKILL_DIR>/scripts/intercom.py send <目标代理ID> <本代理ID> "消息内容"
显著优点
- 100% 零侵入:不修改代理核心代码,纯外部脚本驱动
- 安全合规:首次强制人工审核机制,确保跨代理通信经用户显式授权
- 异步非阻塞:脚本立即返回,不占用会话等待时间
- 去中心化架构:无中央消息服务器,点对点直连降低故障风险
- 轻量依赖:仅需 Python 环境,与 OpenClaw 工具链原生兼容
潜在缺点与局限性
- 手动配置成本:每次新增代理需重复 SOP 分发流程,规模扩大后维护负担显著
- 无消息持久化:脚本级实现,未体现消息队列或存储机制,存在丢包风险
- 无送达确认:异步设计导致无法确认目标代理是否成功接收并处理消息
- 身份验证缺失:依赖代理 ID 字符串匹配,无加密签名或令牌验证
- 协议同步依赖:若某代理未更新 AGENTS.md,将导致通信失败且难以排查
适合人群
- 运行 2-5 个专用 OpenClaw 代理的中高级用户
- 需要代理间简单任务委派(如"dev 更新头像")的轻量协作场景
- 重视合规审计、接受手动安全流程的企业环境
常规风险
- 配置漂移风险:多代理 SOP 版本不一致会导致通信协议碎片化
- 社会工程攻击面:恶意代理若伪造 ID 可能拦截或注入消息
- 脚本权限管控:intercom.py 具备跨目录读写能力,需确保文件权限最小化
- 无日志追溯:当前设计未体现消息审计日志,合规敏感场景需额外补充