WA Relay 是一款专为 OpenClaw 代理设计的 WhatsApp 消息中继与防火墙工具，其核心作用是充当主代理与第三方 WhatsApp 联系人之间的受控网关。通过该中继系统，主代理永远不会直接与外部用户通信，所有消息往来都经过此中间层进行过滤、通知和转发。这种架构不仅增强了隐私保护，还为主代理提供了对消息流的完全掌控能力。
当来自非所有者账户的第三方消息到达时，WA Relay 会立即拦截并阻止原始消息传递，转而向所有者发送一条结构化的通知，包含发件人信息、完整文本内容以及时间戳。如果是语音消息，系统会自动转录为文字后再转发；对于图片、视频或文档等媒体类型，则会尝试转发原文件，并在无法转发时提供详细描述。整个过程确保所有者始终掌握对话动态，而无需频繁查看原始聊天界面。
在响应方面，只有当所有者明确下达指令（如“告诉马丁…”或“回复香蕉…”）后，WA Relay 才会代表所有者向第三方发送消息，并在发送完成后向所有者确认送达状态。此外，所有被中继的对话都会被实时记录到本地日志文件 `memory/wa-relay-log.md` 中，形成可追溯的完整沟通历史，方便所有者随时查询过往交流内容。
核心功能特点
- 自动拦截第三方消息并阻止直接回传，保障主代理不暴露于外部通信
- 实时向所有者推送结构化通知，支持语音转文字及媒体文件转发或描述
- 内置对话日志功能，持续记录所有中继消息以便后续查阅与总结
适用场景
WA Relay 特别适用于需要高度控制个人通讯环境、避免意外泄露敏感信息或希望集中管理多个社交账号的用户场景。例如，企业高管可能使用它来隔离工作相关的 WhatsApp 联系，防止私人助理或客户误触关键指令；远程工作者也可借此工具将重要客户沟通交由可信助手代理处理，同时保留最终决策权。此外，对于注重数字隐私的人群而言，该方案能有效切断自动化脚本或恶意程序通过 WhatsApp 发起的直接交互路径。
另一个典型应用场景是教育领域——教师或研究人员可以配置 WA Relay 接收学生咨询但仅在有明确授权时才代为回复，从而保持学术讨论的专业性和边界感。同样，在家庭环境中，家长可通过此机制监控未成年子女的社交活动，仅在必要时介入回应陌生人的不当请求。无论何种用途，WA Relay 都强调‘被动监听+主动授权’的原则，既满足日常沟通需求，又杜绝了未经许可的行为执行风险。
值得一提的是，该工具对群组聊天的支持同样完善：群内消息会标注群组名称与具体发言者身份，且仅在所有者特别指示的情况下才允许参与讨论。面对短时间内密集发送的多条消息，系统还会智能合并通知，避免信息过载。而对于长时间未获回应的情况，WA Relay 也会适时提醒所有者关注潜在紧急事务，进一步提升沟通效率与安全性。