pywechat

用 Python 操控 PC 微信,4.0 也能自动发消息

pywechat 是一个基于 pywinauto 实现的 Windows 桌面微信自动化工具,面向需要批量、重复操作微信的场景。它通过 UI 自动化直接操控 PC 微信客户端,基本覆盖了微信内置的各项操作,包括消息发送、文件传输、通讯录管理、群聊操作等。相比依赖协议或 Hook 的方案,它走的是模拟人工点击输入的路子,因此在微信 4.0 系列上仍然可用,兼容性相对稳定。项目用 Python 编写,安装后即可调用 API 完成自动化任务,适合做消息群发、自动回复、批量加好友、定时发送等流程。对于不想折腾逆向、又需要在 Windows 上稳定跑微信自动化的开发者来说,这是一个上手门槛较低的选择。

开源 free 自动化工作流
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1966
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类自动化工作流
开发团队Hello-Mr-Crab
所属国家
官网地址
定价模式free
价格说明开源免费,基于pywinauto实现
访问状态
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型python,pywechat,pywinauto,wechat
GitHub 星标★ 1966
30天Star增速
HF 下载量
上线时间2024-11-08 00:00:00
最近更新2026-09-28 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-09-29
浏览次数0

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 5 步

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

环境要求

  • 操作系统:Windows 7 / 10 / 11
  • Python 版本:3.10+(支持 TypeHint)
  • 微信版本:pywechat 需 3.9.12.x,pyweixin 模块需 4.1.6+
  • 系统语言需为简体中文、English 或繁體中文
  • pywechat 仅可用于 32 位 x86 的 Windows 10 或 Windows 7

安装与启动步骤

  1. 1克隆项目仓库

    从 GitHub 拉取 pywechat 源码到本地,需已安装 git 并能访问 GitHub。

    git clone https://github.com/Hello-Mr-Crab/pywechat
  2. 2确认微信版本

    打开 PC 微信查看版本号,pywechat 对应 3.9.12.x,4.1.6+ 请改用仓库内 pyweixin 模块。

  3. 3确认 Python 环境

    保证 Python 3.10 及以上版本可用,且与微信客户端位数、系统匹配。

    python --version
  4. 4阅读官方上手文档

    仓库根目录的 QuickStart.md 与 README(3.9).MD 给出 Skill 使用与快速上手说明,按其中示例操作。

    type QuickStart.md
  5. 5验证模块可导入

    在仓库目录下导入模块验证环境,README 说明所有自动化操作两行代码即可调用。

    python -c "import pyweixin"

如何确认成功

执行 python -c "import pyweixin" 无导入报错,并按 QuickStart.md 示例成功调用 API 即视为就绪。

常见问题

Q:支持微信 4.x 吗?

A:pywechat 只支持旧版本微信(3.9.12.x),大部分方法仍稳定;4.1+ 微信请使用同仓库的 pyweixin 模块。

Q:需要 Hook 或逆向操作吗?

A:不需要。项目基于 pywinauto 实现纯 UI 自动化(pure uiautomation),README 明确说明不涉及逆向 Hook 操作。

Q:自动化时找不到控件怎么办?

A:README 提示应使用 UI 树可见的账号进行 RPA;也可采用其他方法如 OCR 辅助处理 UI 可见性相关问题。

Q:支持哪些界面语言?

A:支持简体中文、English、繁體中文三种语言环境。

注意事项

  • 切勿将该工具用于违反微信使用条例的操作。
  • pywechat 在 32 位 x86 的 Windows 10 或 Windows 7 上使用,其他环境请评估兼容性。
  • 项目当前主要维护支持 4.1 系列自动化的 pyweixin,pywechat 仅支持旧版本微信。
  • 运行自动化时需保持 PC 微信客户端已登录且窗口 UI 树可见。

核心亮点

  • 基于 pywinauto 的 UI 自动化,不依赖协议逆向,微信 4.0 系列仍可用
  • 覆盖消息、文件、通讯录、群聊等 PC 微信内置操作,功能较全
  • 纯 Python 实现,安装调用简单,便于集成到现有自动化流程

不足之处

  • 仅支持 Windows 桌面端,无法在 Mac 或 Linux 上运行
  • UI 自动化对微信版本和界面变化敏感,升级后可能需适配

适用场景

  • 批量给客户或群聊发送通知、营销消息
  • 定时自动回复、关键词回复等客服场景
  • 批量添加好友、导出通讯录等运营操作

替代项目

wechaty、ItChat

项目介绍

pywechat 是自动化工作流领域的开源项目,由 Hello-Mr-Crab 开发,2024 年首次发布。

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

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-28。开源免费,基于pywinauto实现。

它主要面向的使用场景是:批量给客户或群聊发送通知、营销消息。同类可对比的替代方案包括 wechaty、ItChat。

上一篇:agent-wechat

下一篇:没有了!

同类项目推荐

n8n 开源

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

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

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

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

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

★ 263 2026-08-09
robotcode 开源

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

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

★ 302 2026-08-10
puppeteer 开源

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

JavaScript API for Chrome and Firefox

★ 95622 2026-08-10