OpenWA

在构建 WhatsApp 自动化工作流时，商业 API 往往伴随着高昂的费用、功能限制和数据隐私担忧。OpenWA 是一个免费、开源的 WhatsApp API 网关，专为追求完全控制权的开发者设计。它基于可插拔架构，允许你自由切换数据库、存储和缓存后端，彻底摆脱供应商锁定。

核心亮点：开源、灵活、生产就绪

1. 100% 开源，无隐藏成本

• 代码透明：完整源代码访问，无许可费，无功能锁定。
• 自主可控：数据掌握在自己手中，无需担心第三方服务中断或隐私泄露。

2. 可插拔架构，灵活扩展

• 组件解耦：通过配置文件即可切换数据库引擎（SQLite/PostgreSQL）、缓存层（Redis）和存储后端（S3/MinIO），无需修改应用代码。
• 适应性强：从小型个人项目到大型企业级部署，均可按需定制基础设施。

3. 现代化 Web 仪表板

• 可视化管理：基于 React 构建的管理界面，支持会话管理、Webhook 配置、API 密钥生成及监控。
• 交互友好：直观的操作体验，降低运维复杂度。

4. Docker 原生，零配置启动

• 一键部署：提供完整的 docker-compose 配置，支持开发环境与生产环境快速搭建。
• 生态集成：内置 n8n 社区节点，轻松实现工作流自动化。

功能全景

快速开始

方式一：Docker 部署（推荐）

git clone https://github.com/rmyndharis/OpenWA.git
cd OpenWA
docker compose -f docker-compose.dev.yml up -d

启动后访问：

• 管理仪表板: http://localhost:2886
• API 端点: http://localhost:2785/api
• Swagger 文档: http://localhost:2785/api/docs

方式二：本地开发

git clone https://github.com/rmyndharis/OpenWA.git
cd OpenWA
npm install
npm run dev

生产环境配置

OpenWA 提供模块化的 Docker Compose 配置文件，可根据需求组合服务：

API 使用示例

1. 创建新会话

curl -X POST http://localhost:2785/api/sessions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"name": "my-bot"}'

2. 启动会话并获取 QR 码

# 启动会话
curl -X POST http://localhost:2785/api/sessions/{sessionId}/start \
  -H "X-API-Key: YOUR_API_KEY"

# 获取 QR 码图片链接
curl http://localhost:2785/api/sessions/{sessionId}/qr \
  -H "X-API-Key: YOUR_API_KEY"

3. 发送文本消息

curl -X POST http://localhost:2785/api/sessions/{sessionId}/messages/send-text \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "chatId": "628123456789@c.us",
    "text": "Hello from OpenWA!"
  }'

OpenWA 为开发者提供了一条通往 WhatsApp 自动化的自由之路。它不仅解决了商业 API 的成本与限制问题，更通过现代化的架构设计（可插拔、Docker 化、多会话支持）确保了系统的稳定性与可扩展性。