python-whatsapp-bot

纯 Python 快速搭建 AI 微信机器人，对话即服务

python-whatsapp-bot 是一个用纯 Python 构建 AI WhatsApp 机器人的开源框架。它解决了开发者无法快速、低成本地将 AI 能力接入 WhatsApp 的痛点，无需掌握复杂的 WhatsApp Business API 或 Node.js。项目核心能力包括：基于 Python 的简洁 API 设计，支持快速定义消息处理逻辑；内置对多种 AI 模型（如 OpenAI、Gemini）的集成，可轻松实现智能对话、自动回复；提供消息收发、会话管理、媒体处理等基础功能；支持通过 Webhook 或轮询方式接收消息，便于部署。它适合个人开发者、小团队快速搭建客服机器人、通知机器人或趣味聊天机器人，降低了 WhatsApp 生态的 AI 应用开发门槛。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1533

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队daveebbelaar

所属国家

官网地址https://www.datalumina.com

GitHubhttps://github.com/daveebbelaar/python-whatsapp-bot

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,flask,llm,openai,python,whatsapp

GitHub 星标★ 1533

30天Star增速

HF 下载量

上线时间2023-10-10 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数8

使用教程

难度：进阶约 30 分钟部署方式：本地安装 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Meta(Facebook)开发者账号
已创建的业务应用(Business App)
具备 Python 基础，能读懂并运行 Flask 项目
本地可运行 Python 服务并能通过 ngrok 暴露公网地址

安装与启动步骤

1注册开发者账号

前往 Meta 开发者平台注册账号并完成必要的开发者验证，这是使用 WhatsApp Cloud API 的前提。
2创建业务应用

在开发者后台新建应用；若列表中没有 Business 选项，选择 Other > Next > Business 创建。
3选择电话号码

按 README 的 Step 1，在应用的 WhatsApp 产品下选择/绑定用于收发消息测试的电话号码。
4用 API 发消息

按 README 的 Step 2，先用 Cloud API 成功发出一条测试消息，验证凭证与号码配置正确。
5启动 Flask 应用

按 README 的 Get Started 章节在本地运行该 Flask 服务，具体启动命令以仓库 README 为准。
6启动 ngrok

按 README 的 Launch ngrok 小节，把本地服务暴露为公网 HTTPS 地址，供 Meta 回调访问。
7配置 Webhook

按 README 的 Step 3，在 Meta 后台填入回调地址与验证 Token，订阅消息事件以实时收消息。

如何确认成功

Meta 后台 Webhook 验证通过，且给绑定的测试号码发消息能收到 OpenAI 生成的自动回复。

常见问题

Q：没有 Meta 开发者账号能跑起来吗？

A：不能。README 明确要求先注册 Meta 开发者账号并创建业务应用，否则拿不到 WhatsApp Cloud API 的调用权限。

Q：创建应用时找不到 Business 选项怎么办？

A：按 README 说明，选择 Other，点击 Next，再选择 Business 即可创建业务类型应用。

Q：本地服务怎么被 Meta 回调访问？

A：README 要求用 ngrok 把本地 Flask 服务暴露成公网 HTTPS 地址，再把该地址填到 Webhook 回调 URL 中。

Q：这个项目需要 Node.js 吗？

A：不需要。README 标题即为 Pure Python，教程用纯 Python 加 Flask 完成，无需 Node.js。

注意事项

README 节选未给出具体安装命令，实际安装与启动命令请以仓库 Get Started 章节为准。
需要一定的 Python 基础才能跟进本教程。
整个过程依赖 Meta 开发者账号、业务应用和 WhatsApp Cloud API 权限。

核心亮点

纯 Python 实现，上手快，无需学习 Node.js 或复杂 API
内置 OpenAI、Gemini 等 AI 模型集成，几行代码实现智能回复
提供清晰的示例和文档，支持 Webhook 与轮询两种消息接收方式

不足之处

依赖 WhatsApp 非官方接口，存在账号封禁风险
文档/社区待观察

适用场景

个人开发者快速搭建 AI 聊天机器人
小团队实现客服自动回复或通知推送
教育场景演示 AI 对话应用

替代项目

whatsapp-web.js、Baileys、WPPConnect

项目介绍

python-whatsapp-bot 是对话助手领域的开源项目，由 daveebbelaar 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,533）位列前 30%，在对话助手分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：个人开发者快速搭建AI聊天机器人。同类可对比的替代方案包括 whatsapp-web.js、Baileys、WPPConnect。

上一篇：Klee

下一篇：local-cocoa