python-wechaty

用 Python 一套代码，搞定微信/WhatsApp 聊天机器人

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 244 🐛 待处理 166 👀 关注 24

GitHub ↗

GitHub 星标 ★ 1825

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源SDK，完全免费，无付费版本。

项目预览

python-wechaty 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队wechaty

GitHubhttps://github.com/wechaty/python-wechaty

定价模式🏷️完全免费

价格说明开源SDK，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型chatbot,python,wechat,wechaty,whatsapp

GitHub 星标★ 1825

上线时间2018-08-25 00:00:00

代码更新2025-06-20

仓库体积1.1 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数2

项目介绍

python-wechaty 是 Wechaty 的 Python 版本，一个面向聊天机器人开发者的对话式 RPA（机器人流程自动化）SDK。它解决了开发者需要为不同 IM 平台（如微信、WhatsApp）分别编写适配代码的痛点，提供统一的编程接口，让开发者可以用 Python 快速构建跨平台的聊天机器人。核心能力包括：通过 Puppet 抽象层对接多种 IM 协议，支持消息收发、联系人管理、群聊操作、好友请求处理等常见功能，并提供了丰富的插件和中间件机制，方便扩展。项目目前处于成长阶段，API 设计借鉴了 TypeScript 版 Wechaty，但 Python 生态的集成（如 asyncio）使其更适合 Python 开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1825

技术标签

chatbot python wechat whatsapp

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 5 分钟部署方式：库/依赖 3 步

环境要求

已安装 Python 环境（README 未注明具体版本要求）
可用的 pip3 包管理工具
目标 IM 平台对应的 puppet token（README 提到通过切换 token 类型切换平台）

安装与启动步骤

1安装 wechaty 库

使用 pip3 从 PyPI 安装 python-wechaty 包，这是唯一在 README 中明确给出的安装命令。建议在虚拟环境中执行，避免污染全局环境。
```
pip3 install wechaty
```
2获取机器人模板

README 提供了一个官方 bot-template 仓库，用于快速开始编写机器人。克隆到本地后可直接在其基础上修改代码。
```
git clone https://github.com/wechaty/python-wechaty-template
```
3查阅中文文档

README 指向中文文档站点，包含更完整的使用说明与 API 介绍，遇到不清楚的用法时优先查阅该文档。