核心用法
wa-relay 是 OpenClaw 的 WhatsApp 消息隔离与授权中继系统，采用双代理架构实现隐私保护：
- 主代理 (Main agent)：仅接收机主本人发送的消息，保持纯净对话环境
- 中继代理 (Relay agent)：接收所有第三方私信，立即通知机主，但未经授权绝不自动回复
配置流程简洁：运行 setup.sh 绑定机主手机号 → 执行 configure.sh 生成配置 → 导入 OpenClaw 系统即可启用。
显著优点
1. 隐私防火墙：彻底隔离陌生人与主代理，避免模型通过对话历史推断机主身份、日程或敏感信息
2. 授权机制：所有第三方消息需机主显式批准后才生成回复，杜绝意外泄露
3. 透明操作：setup 脚本在关键步骤（凭证复制、系统补丁）前强制确认，并创建 .bak 备份
潜在局限
- 临时补丁依赖：需修改 OpenClaw 核心文件的
SAFE_SESSION_ID_RE正则表达式，以兼容 WhatsApp 手机号格式（+、-字符），该补丁对应已知 bug #16211，PR #16531 合并后可移除 - 凭证共享风险：主代理的
auth-profiles.json需复制至中继代理，虽为功能必需，但扩大了凭证暴露面 - 版本锁定：仅支持 OpenClaw v2026.2.14+，升级兼容性待验证
适合人群
- 使用 OpenClaw 搭建 WhatsApp 个人助理的隐私敏感用户
- 需要过滤商业合作咨询、避免主代理被无关对话"污染"的专业人士
- 希望保留完整消息审计日志（机主审批记录）的合规场景
常规风险
- 补丁操作若中断可能导致 OpenClaw 会话验证失效，需手动恢复
.bak文件 - 中继代理持有完整模型凭证，若部署环境不安全，可能成为横向移动跳板
- 手机号格式配置错误将导致消息路由失败，建议严格使用国际格式（如
+573001234567）
---
安全提示：补丁操作涉及核心文件修改，建议在测试环境验证后再部署至生产。