OpenWA 是一款免费、开源、可自托管的 WhatsApp API 网关,它帮你绕过 WhatsApp 官方商业 API 的高门槛(如资质审核、月费、消息模板限制),直接在自己的服务器上搭建稳定可靠的 WhatsApp 消息收发服务。无论你是想为客服系统接入 WhatsApp,还是开发营销机器人、内部通知工具,甚至构建多租户 SaaS 应用,OpenWA 都能提供灵活、安全、不被厂商锁定的技术底座。
核心功能
- 零依赖扫码登录:无需 WhatsApp Business 账号或官方认证,仅需一部已注册的 WhatsApp 手机号,扫码即可快速接入,支持多设备会话管理
- 统一 RESTful API 接口:提供标准化 HTTP 接口(JSON 格式),轻松发送文本、图片、文件、联系人、位置、按钮消息等,兼容各类后端语言(Python/Java/PHP/Node.js 等)
- 插件化架构设计:数据库可自由切换 SQLite(开发轻量)或 PostgreSQL(生产高并发);文件存储支持本地磁盘或 AWS S3/MinIO;缓存层可选内存或 Redis,扩展性极强
- 开箱即用的 Docker 支持:一键拉取镜像、配置环境变量、启动服务,5 分钟完成部署,大幅降低运维门槛
- 完整事件驱动模型:实时接收消息到达、已读回执、群组变更、联系人更新等 20+ 类事件,并支持 Webhook 推送至你的业务系统
- 企业级稳定性保障:基于 NestJS 11 + TypeScript 5 构建,内置自动重连、会话持久化、错误日志追踪与健康检查接口,适合 7×24 小时运行
适合哪些人用
如果你是以下角色,OpenWA 就是为你量身打造的工具:
- 独立开发者:想快速验证 WhatsApp 自动化创意(比如预约提醒、订单通知),不想被商业 API 的复杂流程卡住
- 中小型企业 IT 团队:需要将 WhatsApp 接入现有 CRM 或工单系统,又不愿每月支付高昂 API 费用或接受数据出境风险
- SaaS 服务商:计划为客户提供“WhatsApp 通知通道”作为增值模块,OpenWA 提供白标集成能力与多租户隔离基础
- 教育/非营利组织:预算有限但急需低成本触达用户,例如学校通知、社区公告、公益信息推送
快速上手
只需三步,立即启用:
- 准备环境:安装 Node.js 22 LTS(推荐)或使用 Docker;确保服务器可访问互联网(WhatsApp Web 需要网络连接)
- 启动服务(Docker 方式最简):
docker run -d --name openwa -p 8080:8080 -e TZ=Asia/Shanghai rmyndharis/openwa - 扫码登录 & 调用 API:浏览器打开
http://localhost:8080,扫描二维码绑定手机;随后通过POST /api/send-message等接口发送消息,文档示例丰富,含 cURL、JavaScript、Python 多语言调用片段
详细配置(如换数据库、加 HTTPS、设 Webhook)可查阅项目内置中文友好文档(docs 目录)及在线 Swagger API 页面。
项目信息
Free, Open Source, Self-Hosted WhatsApp API Gateway
4.7k
今日 +726 stars today
Stars
955
Forks
TypeScript
MIT
TypeScript|GitHub Star 数:4671|开源协议:MIT|GitHub 项目地址
它不是另一个“WhatsApp 模拟器”,而是一套真正生产就绪、持续迭代、社区活跃的 WhatsApp 基础设施层——把控制权还给开发者,让 WhatsApp 成为你技术栈里可信赖的一环。



