项目简介
OpenWA 是一款免费开源 WhatsApp API 网关,为开发者提供 REST API、Webhook、多会话管理和网页控制台。基于 NestJS 和 TypeScript 构建,支持 SQLite/PostgreSQL 和 Docker 部署。
README 预览
\n \n\n\nOpenWA\n\n Open Source WhatsApp API Gateway\n\n\n\n Features •\n Quick Start •\n Docs •\n API •\n Contributing\n\n\n\n \n \n \n \n \n \n\n\n---\n\n## ✨ Why OpenWA?\n\n**OpenWA** is a free, open-source WhatsApp API Gateway designed for developers who need full control over their messaging infrastructure—without vendor lock-in or hidden paywalls.\n\nBuilt on a **pluggable architecture**, OpenWA lets you swap database engines (SQLite/PostgreSQL), storage backends (Local/S3), and cache layers (Memory/Redis) without changing a single line of application code.\n\n| | |\n| ----------------------------- | ------------------------------------------------------------ |\n| 🔓 **100% Open Source** | No licensing fees, no feature locks, full source code access |\n| 🏗️ **Pluggable Architecture** | Swap adapters for database, storage, and cache via config |\n| 🖥️ **Full Dashboard** | Modern React UI for session, webhook, and API key management |\n| 🔹 **Multi-Session Ready** | Run multiple WhatsApp sessions concurrently on one instance |\n| 🐳 **Docker Native** | Production-ready with zero configuration |\n| 🔗 **n8n Integration** | Community nodes for workflow automation |\n\n---\n\n## 🎯 Features\n\n### Core Features\n\n| Feature | Status | Description |\n| ------------- | ------ | ------------------------------------ |\n| REST API | ✅ | Full WhatsApp API via HTTP endpoints |\n| Multi-Session | ✅ | Manage multiple WhatsApp accounts |\n| Webhooks | ✅ | Real-time events with HMAC signature |\n| Web Dashboard | ✅ | Visual management interface |\n| API Key Auth | ✅ | Secure API authentication |\n| Swagger Docs | ✅ | Interactive API documentation |\n\n### Messaging\n\n| Feature | Status |
常见问题 (1)
故障排除使用OpenWA WhatsApp自动化会导致我的账号被封禁吗?如何降低风险?
故障排除
使用OpenWA WhatsApp自动化会导致我的账号被封禁吗?如何降低风险?是的,使用非官方WhatsApp自动化存在账号封禁风险。有用户反映即使使用频率低且不发送垃圾信息仍遭封禁。为降低风险,请遵循OpenWA文档中的缓解策略:严格执行速率限制、在消息之间添加合理延迟、避免向未知号码批量发送消息、切勿重复使用相同消息模板。请查阅风险管理文档:https://github.com/rmyndharis/OpenWA/blob/main/docs/16-risk-management.md。注意:使用OpenWA进行扫描可能导致WhatsApp移除已关联设备。