关于 wa2agent
wa2agent 是托管式、只读的 WhatsApp MCP 服务,供需要读取指定聊天的 Agent 使用。用户可选择共享哪些对话,并通过 MCP 连接或用电子邮件接收新消息,无需在本地运行软件。
主要功能
- 01读取选定的 WhatsApp 聊天
- 02选择共享群组和私聊
- 03通过电子邮件接收新消息
- 04加密存储消息
- 05不下载媒体文件
适用场景
- 01将学校或家庭聊天整理成任务和活动
- 02从工作对话中整理后续事项
- 03根据共享聊天生成每日简报
MCP 相关
wa2agent 通过托管 MCP 服务向 MCP 客户端开放选定的 WhatsApp 聊天。新消息也可通过电子邮件发送到 Agent 能读取的收件箱。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://vault-{vault_id}.wa2agent.link/mcpclaude mcp add --transport http rosroyros-wa2agent https://vault-{vault_id}.wa2agent.link/mcp{"mcpServers":{"rosroyros-wa2agent":{"type":"http","url":"https://vault-{vault_id}.wa2agent.link/mcp"}}}在 Cursor 中打开{"servers":{"rosroyros-wa2agent":{"type":"http","url":"https://vault-{vault_id}.wa2agent.link/mcp"}}}在 VS Code 中打开{"mcpServers":{"rosroyros-wa2agent":{"type":"http","url":"https://vault-{vault_id}.wa2agent.link/mcp"}}}{"mcpServers":{"rosroyros-wa2agent":{"serverUrl":"https://vault-{vault_id}.wa2agent.link/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://vault-{vault_id}.wa2agent.link/mcp需要授权https://demo.wa2agent.link/mcp需要授权工具
详细介绍
wa2agent:适用于 Claude、Codex 和其他 AI Agent 的只读 WhatsApp MCP
wa2agent 为你的 AI Agent 提供只读访问权限,让它读取你选择的 WhatsApp 聊天。它是托管式 WhatsApp MCP 服务:你的 Agent 通过 MCP 连接(或通过电子邮件读取新消息),你无需在自己的电脑上运行任何程序。
此代码库包含用于完成设置的 Agent 技能。
如何让 Claude(或其他 Agent)读取我的 WhatsApp?
- 在 https://wa2agent.link 创建一个 vault,然后像添加 WhatsApp Web 一样,通过手机关联 WhatsApp。
- 选择要共享的聊天:单个群组和私聊、所有群组、所有私聊,或全部聊天。
- 连接你的 Agent:将 vault 的 MCP 地址添加到 Claude、Claude Code、Codex 或任何 MCP 客户端,也可以启用邮件投递,将消息发送到 Agent 已在读取的收件箱。
然后,你的 Agent 就可以将学校、家庭和工作群组中的内容整理成活动、任务、后续事项和每日简报。
这与 lharries/whatsapp-mcp 和其他免费服务有何不同?
如果你想完全掌控,并且能够让电脑持续运行、更新桥接程序并在故障时进行修复,那么自托管服务(例如 lharries/whatsapp-mcp)是不错的选择。wa2agent 会为你运行连接,因此即使笔记本电脑关机,你的 Agent 也能读取共享的聊天内容。此外,它在设计上就是只读的:你的 Agent 无法通过它发送 WhatsApp 消息。
安全吗?
- 只读。 你的 Agent 无法通过 wa2agent 发送消息。
- 由你选择聊天。 你可以随时更改或撤销共享。
- 加密存储。 存储的消息使用只有你的 Agent 持有的密钥加密,因此 wa2agent 无法读取。新消息会先经过服务,然后才加密;服务会处理聊天名称和消息时间,以便投递消息。
- 短期保留。 选中的文本消息会保留 30 天。不会下载媒体文件。
- 提示注入。 共享聊天中的任何人都可以编写你的 Agent 会读取的文本。此技能会指示你的 Agent 将消息视为源材料,而非指令;只读访问意味着即使 Agent 受到诱骗,也无法向你的联系人发送消息。
- WhatsApp 账户。 wa2agent 会以关联设备的方式连接,与 WhatsApp Web 相同。它不是 WhatsApp 官方产品;关联设备可执行的操作由 WhatsApp 决定。
详情:隐私和存储。
将 WhatsApp 连接到 AI 的其他方式
正在比较不同方案?Awesome WhatsApp MCP 列出了自托管服务、托管服务、Business API 和免费导出方案及其风险。它还提供一项免费技能,可读取 WhatsApp 聊天导出内容,无需账户。
安装技能
使用 skills CLI:
npx skills add rosroyros/wa2agent-skills
或者将 skills/wa2agent-whatsapp/ 复制到 Agent 的技能文件夹中,例如 .claude/skills/(Claude Code)或 .agents/skills/(Codex)。
然后对你的 Agent 说:“用 wa2agent 连接我的 WhatsApp,这样你就能读取我的学校和家庭群组。”
已使用全新 Claude Code 和 Codex Agent 进行测试:先设置 vault,然后在新会话中读取一条消息和一封导出邮件。
Agent 指南
关于
wa2agent 目前仅限邀请加入;请前往 https://wa2agent.link/login 加入候补名单。问题请联系:[email protected]。
由 Roy Rosenfeld 构建并运营。基于开源 WhatsApp 连接工具构建,包括 wacli 和 whatsmeow。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。