核心用法
wa-relay 是 OpenClaw 平台的 WhatsApp 消息路由技能,采用双代理架构实现第三方私信的隔离审核:
1. 中继代理接收陌生号码的 WhatsApp 消息
2. 通过 sessions_send 将消息转发至主代理会话
3. 中继代理立即返回 NO_REPLY,避免直接回复发件人
4. 主代理接收消息后通知机主,并提供建议回复内容
5. 机主决定采用、修改或重写回复,最终由主代理发出
白名单机制:预设号码(如亲友)可绕过中继,直接与主代理对话(等同机主权限)。
显著优点
- 隐私隔离:陌生消息不直接触达主代理,降低信息泄露与即时响应压力
- 人机协同:AI 生成建议草稿,人类保留最终决策权,避免自动回复失误
- 白名单灵活:重要联系人享受无摩擦体验,陌生人必须经过审核流程
- 轻量部署:通过
setup.sh/configure.sh脚本自动化配置,约 3 步完成
潜在缺点与局限性
- 架构复杂度高:需维护双代理、跨会话通信,故障排查难度增加
- 实时性折损:消息需经两次转发+人工审核,延迟显著高于直接回复
- 平台锁定:深度依赖 OpenClaw 生态与 WhatsApp 通道,迁移成本极高
- 临时补丁风险:需修改 OpenClaw 核心文件的会话 ID 正则(等待官方修复 PR #16531)
适合人群
- 公众人物/企业客服:需要筛选大量陌生 WhatsApp 私信,防止骚扰与钓鱼
- 高隐私需求用户:不愿将个人号码暴露给 AI 自动回复系统
- OpenClaw 深度用户:已熟悉多代理架构,能接受手动配置与调试
常规风险
- 凭证共享:安装脚本需复制
auth-profiles.json至中继代理,存在横向泄露风险 - 补丁回滚遗漏:若忘记移除临时正则补丁,未来 OpenClaw 升级可能引发兼容性问题
- SOUL.md 污染:自动注入的配置可能覆盖自定义指令,建议安装后人工复核
- 审核疲劳:高消息量场景下,机主可能因频繁决策压力而放弃审核、直接放行