核心用法
wa-relay 是一款专为 OpenClaw 设计的 WhatsApp 消息中继防火墙工具。其核心架构采用双代理分离模式：主代理（Main agent）仅接收来自主人的消息，中继代理（Relay agent）则处理所有第三方私信，形成天然的消息隔离层。
典型工作流程：
1. 第三方发送私信 → 中继代理接收并立即通知主人
2. 主人审阅后授权 → 中继代理才生成回复
3. 未经授权的消息始终处于待处理队列，不会自动响应
配置流程：执行 scripts/setup.sh 初始化环境，运行 scripts/configure.sh 生成配置 JSON，最后导入 OpenClaw 系统完成部署。需确保 OpenClaw 已配置 WhatsApp 通道，且主人号码使用国际格式（如 +573001234567）。
显著优点
- 零误触防护：默认静默模式，彻底杜绝 AI 对陌生人的自动回复
- 主从分离架构：主人对话与第三方请求物理隔离，避免上下文污染
- 轻量部署：仅两个 shell 脚本，无额外依赖
- 隐私可控：敏感消息需人工授权后才暴露给 AI 处理
潜在局限
- 实时性折中：紧急消息需等待主人授权，存在延迟
- 单点依赖：主人离线时中继代理完全静默，可能遗漏重要联系
- OpenClaw 绑定：无法独立运行，必须与特定 AI 框架配合使用
- 缺乏审计日志：未提及消息留存与查询机制
适合人群
- 使用 OpenClaw 且 WhatsApp 作为主力渠道的内容创作者/商家
- 需过滤粉丝私信、防止 AI 误回敏感问题的用户
- 对 AI 自动回复有强管控需求的专业场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 配置泄露 | `configure.sh` 生成的 JSON 含敏感参数，需妥善保管 |
| 号码伪造 | WhatsApp 存在 SIM swapping 与号码冒充攻击向量 |
| 授权误操作 | 快速授权可能引入钓鱼/欺诈内容进入对话流 |
| 通道单点故障 | OpenClaw WhatsApp 通道中断将导致服务完全失效 |