python-wechaty

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

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

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1825
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队wechaty
所属国家
官网地址
定价模式free
价格说明开源SDK,完全免费,无付费版本。
访问状态
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型chatbot,python,wechat,wechaty,whatsapp
GitHub 星标★ 1825
30天Star增速
HF 下载量
上线时间2018-08-25 00:00:00
最近更新2026-09-19 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数1

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 wechaty 库

    使用 pip3 从 PyPI 安装 python-wechaty 包,这是唯一在 README 中明确给出的安装命令。建议在虚拟环境中执行,避免污染全局环境。

    pip3 install wechaty
  2. 2获取机器人模板

    README 提供了一个官方 bot-template 仓库,用于快速开始编写机器人。克隆到本地后可直接在其基础上修改代码。

    git clone https://github.com/wechaty/python-wechaty-template
  3. 3查阅中文文档

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

如何确认成功

执行 pip3 install wechaty 无报错后,在 Python 中运行 import wechaty 不抛 ImportError,即说明安装成功。

常见问题

Q:安装后不知道怎么写出第一个机器人?

A:README 建议直接使用官方提供的 python-wechaty-template 模板仓库,克隆后在模板代码基础上修改,比从零编写更快。

Q:如何让同一个机器人运行在不同的 IM 平台上?

A:README 说明 python-wechaty 支持多平台,一份代码即可通用,你只需要切换所使用的 token 类型即可。

Q:Python 版本有要求吗?

A:README 未给出明确的 Python 版本要求,建议使用较新的 Python 3 环境,并参考官方中文文档确认。

注意事项

  • README 只提供了 pip3 install wechaty 这一条安装命令,其他配置与运行细节需参考官方模板仓库和中文文档。
  • 项目自述处于成长阶段,API 设计借鉴 TypeScript 版 Wechaty,Python 生态集成仍在完善,升级时注意版本变化。
  • 支持 WhatsApp、微信、企业微信、Gitter、Lark 等平台,切换平台只需更换 token 类型。
  • 请遵守所接入 IM 平台的用户协议与相关规定,合理使用自动化能力。

核心亮点

  • 统一 API 屏蔽多 IM 差异,一次开发多平台运行
  • 基于 asyncio,与 Python 异步生态无缝集成
  • 活跃社区,Wechaty 生态提供丰富 Puppet 实现

不足之处

  • Python 版功能相对 TypeScript 版滞后,部分 Puppet 支持不完善
  • 文档示例偏少,新手上手需参考 TypeScript 版

适用场景

  • 个人微信/企业微信自动化助手(如自动回复、群管理)
  • 跨平台客服机器人,统一对接微信和 WhatsApp
  • 快速原型验证聊天机器人想法,无需关注底层协议

替代项目

Wechaty (TypeScript)、ChatterBot、Rasa

项目介绍

python-wechaty 是自动化工作流领域的开源项目,由 wechaty 开发,2018 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,825)位列前 30%,在自动化工作流分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-19。开源SDK,完全免费,无付费版本。

它主要面向的使用场景是:个人微信/企业微信自动化助手(如自动回复、群管理)。同类可对比的替代方案包括 Wechaty (TypeScript)、ChatterBot、Rasa。

上一篇:llm-workflow-engine

下一篇:FlowBot

同类项目推荐

n8n 开源

拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。

Fair-code workflow automation platform with native AI capabilities. Combine visual b···

★ 205700 2026-08-10
feishu-docx 开源

让 AI 代理轻松读写飞书文档,双向转换 Markdown

Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···

★ 262 2026-08-09
robotcode 开源

让 Robot Framework 拥有现代 IDE 体验,调试、补全、运行一气呵成。

Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···

★ 301 2026-08-10
puppeteer 开源

用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。

JavaScript API for Chrome and Firefox

★ 95609 2026-08-10