这个基于Python的项目旨在打造一个运行在WhatsApp Web上的自动化聊天机器人。它不仅支持基础的自动回复，更深度集成了AI能力，让你能够用自然、智能的方式管理WhatsApp对话。

gitee地址：https://gitee.com/wangfsgit/whatsapp_bot_ai.git，
github地址：https://github.com/wangfs-2th/whatsapp_bot_ai.git。

核心功能亮点

whatsapp_bot_ai 的功能设计非常全面，涵盖了从消息处理、智能回复到数据管理的方方面面：

功能类别 具体能力

智能回复 支持关键词匹配、本地内容库以及AI智能回复（OpenAI GPT系列 / 通义千问），具备防重复机制和聊天上下文理解能力。

消息管理 支持单条、批量、定时发送消息，提供精细的消息频率控制以防止账号风险，并完整记录消息历史。

联系人管理 可灵活配置回复所有联系人或指定列表，并能智能过滤群组消息。

多语言翻译 内置翻译模块，支持自动翻译接收和发送的消息（中、英、日、俄等），轻松应对跨语言沟通。

文件知识库 支持上传 Word、Excel 文档，自动提取内容作为AI的知识来源，让回复更专业、更贴合业务。

可视化Web界面 提供直观的操作后台，可实时监控状态、在线配置参数、管理文件和查看聊天记录，无需编写代码即可操控机器人。

快速上手指南

项目的设计考虑到了易用性，你可以通过以下几个典型步骤快速启动并运行它：

准备环境：确保你的电脑已安装 Python 3.8+ 和 Chrome浏览器。

获取代码：通过Git克隆或直接下载项目源码。

安装依赖：在项目目录下运行 pip install -r requirements.txt 安装所有Python包。

配置密钥：在项目根目录创建 .env 文件，填入你的OpenAI或通义千问API密钥，并根据需要设置AI的性格、回复延迟、联系人范围等参数。

启动服务：运行 python main.py，程序会自动启动Web服务器并在浏览器中打开管理界面（默认地址 http://localhost:5000）。

登录并激活：在Web界面上点击“获取二维码”，用手机WhatsApp扫描完成登录，然后点击“启动机器人”即可开始工作。

核心模块与技术栈

项目采用了模块化的设计思想，主要模块清晰划分，便于理解和二次开发：

whatsapp_client.py：基于 Selenium 的WhatsApp Web客户端，负责登录、消息监听与发送。

auto_reply.py & ai_reply.py：自动回复的核心逻辑，协调本地回复与AI回复的生成。

database.py：使用 SQLite 数据库，用于存储消息历史、定时任务等。

translator.py：集成翻译功能，实现多语言无缝切换。

file_reader.py：负责读取并解析上传的Word、Excel文档。

web_server.py：基于轻量级框架搭建的Web管理后台，提供丰富的API接口。

项目提供了完整的 HTTP API 接口，涵盖了状态获取、登录、消息发送（单条/批量）、配置管理、文件上传和聊天记录查询等操作，方便开发者将其集成到更复杂的系统中。

结语

whatsapp_bot_ai 是一个非常成熟且功能丰富的开源项目。它将Selenium自动化、AI大模型、数据库管理和Web可视化等技术有机地结合在一起，为开发者提供了一个强大的WhatsApp自动化解决方案。无论你是想为自己搭建一个智能助理，还是希望研究其技术实现，这个项目都非常值得一试。