适合谁
- 开发者和技术爱好者，希望自托管 WhatsApp API 网关
- 需要将 WhatsApp 自动化能力集成到 AI 智能体的场景
- 个人项目或内部工具，需要低成本的消息自动化
- 愿意接受非官方 API 风险和账户限制的开发者
O
47FMRS · D
OpenWA 提供了一个轻量级的 MCP 服务器，用于将 WhatsApp 自动化能力安全地暴露给 AI 智能体，但需要开发者具备一定的部署和配置经验，并接受非官方 API 的风险。
OpenWA 是一个免费、开源、可自托管的 WhatsApp API 网关，提供 REST API、Webhook、多会话管理、Web 仪表盘等功能。它支持通过配置切换数据库、存储和缓存后端，并可通过设置 MCP_ENABLED=true 启用 MCP 服务器，在现有服务上挂载 /mcp 端点，暴露 51 个精选工具（会话、消息、联系人、基础群组操作、Webhook 读取、标签、自动化规则读取），供 AI 智能体（如 Claude、Cursor）调用。MCP 服务器默认关闭，启用后所有 REST 路由保持不变。
工具能力
51 curated tools (sessions, messaging, contacts, basic group ops, webhook reads, labels, automation-rule reads)
提供会话管理、消息发送/接收、联系人管理、基础群组操作、Webhook 读取、标签管理、自动化规则读取等 51 个精选工具，供 AI 智能体调用。
安装接入
- 克隆仓库：git clone https://github.com/rmyndharis/OpenWA.git && cd OpenWA\n2. 启动 Docker 容器：docker compose -f docker-compose.dev.yml up -d（或使用生产部署命令）\n3. 设置 MCP_ENABLED=true 环境变量（可在 .env 或 docker-compose 中设置）\n4. 重启服务：npm run start:prod 或重启容器\n5. 配置 MCP 客户端（如 Claude Code 的 .mcp.json），指定 URL 为 http://localhost:2785/mcp，并在请求头中携带 API 密钥。
claude_desktop_config.json
{
"mcpServers": {
"openwa": {
"type": "http",
"url": "http://localhost:2785/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
选型与风险
不适合谁
- 需要官方 WhatsApp Cloud API 保证合规的生产环境（如医疗、金融、大规模商业消息）
- 无法接受账户封禁风险的用户
- 希望零配置即可使用的用户（需要一定部署和配置）
- 需要完整 REST API 覆盖的场景（MCP 只暴露精选工具）
所需权限
- 需要 API 密钥认证（role 为 OPERATOR 或更低，session-scoped）
- 可能需要访问 Docker 套接字（如果使用内置编排，但有 docker-proxy 保护）
- MCP 端点需要可从客户端访问（如 localhost 或局域网）
- 建议使用专用 WhatsApp 号码，避免主号风险
风险与副作用
- 非官方 WhatsApp API，存在账户被限制或封禁的风险
- 消息可能被 WhatsApp 服务器端丢弃（首次发送给新联系人）
- 需要定期检查依赖更新，以应对 WhatsApp 协议变化
- MCP 端点如果暴露到公网，可能被滥用（需前置认证代理）
常见排障
- 检查 MCP_ENABLED 是否已设置且服务已重启
- 确认 API 密钥是否有效，且有正确的角色和会话范围（不能带 IP 白名单）
- 检查网络连接，确保客户端能访问 /mcp 端点
- 查看服务日志，确认 MCP 是否成功挂载
- 验证请求头 Authorization 或 X-API-Key 是否正确
使用场景
让 AI 智能体自动回复 WhatsApp 消息
通过 AI 助手发送定时消息或通知
自动化客户支持流程，AI 代理处理常见咨询
集成聊天机器人到 WhatsApp 群组
支持客户端
Claude Desktop完整支持
Cursor完整支持