微信UI自动化项目对比:wxauto / wechatauto-replica / WXAUTO_SE / WeChatAuto.SDK / wechat-automation-api
微信UI自动化项目对比:wxauto / wechatauto-replica / WXAUTO_SE / WeChatAuto.SDK / wechat-automation-api
调研日期:2026-08-31 | 数据来源:GitHub API(星标/归档状态/issue/release 实测)、PyPI(pypistats 下载量实测)、各仓库 README
目录定位:微信 PC 客户端 UI 自动化(UIAutomation/RPA,非 hook、非协议) 路线的自动回复/机器人方案统一收在此文件。与 AI社交项目对比(聊天应用层)互补。
⚠️ 背景知识:微信 4.x 是分水岭(2026 年格局)
- UI 自动化原理:用 Windows UIAutomation/键鼠模拟操作”真人微信客户端”,官方风控视角最接近真人操作,是当前个人微信号风险最低的自动化路线(hook 注入 dll 的路线已集体退场:WeChatFerry 6797★、NGCBot 3302★ 均已归档)。
- 版本分水岭:微信 4.x 客户端改用自绘渲染,抛弃了 UIA 无障碍树,导致经典 wxauto 一代方案整体失效。4.x 时代的存活方案要么走”本地数据库解密(SQLCipher4) + UIA/OCR 混合发送”(wechatauto-replica),要么靠厂商持续适配新版本(WeChatAuto.SDK)。
- 封号共识:个人微信号任何非官方自动化都有风险;UI 自动化最低但不是零。社区共识是用小号、控制频率、勿群发加粉。
一句话对比
| 项目 | 星标 | 下载/月 | License | 微信版本 | 定位 | 活跃度 | 上手 |
|---|---|---|---|---|---|---|---|
| A. wxauto | 7286★ · 1382 fork | PyPI 135(转官网分发) | Apache-2.0 | 仅 3.9.x | UI 自动化事实标准,生态最大 | 🔴 开源版 2025 冻结转商业 | 低 |
| B. wechatauto-replica | 134★ | PyPI 6882 | Apache-2.0 | 4.1.12+ | wxauto 的 4.x 兼容替代品 | 🟢 极活跃(当日发版) | 中 |
| C. WeChatBot_WXAUTO_SE | 879★ | - | - | 3.9.x | 成品”微信AI自动回复”应用(wxauto+LLM) | 🔴 停止维护 | 中(当模板抄) |
| D. WeChatAuto.SDK | 255★ | - | MIT(80%开源) | 3.9.12.x + 4.1.11.x | .NET 微信 RPA SDK | 🟢 很活跃(当日提交) | 中(需.NET) |
| E. wechat-automation-api | 171★ | - | 无(未声明) | 4.0+ | 给 AI Agent 用的”发微信”Skill/HTTP API | 🟡 维护中 | 低 |
📌 定位区分:A/B/D 是库(自己写代码)、C 是现成应用(装上就能 AI 自动回复)、E 只管发送不管接收(Agent 主动推送场景)。收+发+AI 回复的完整闭环:3.9.x 选 C 的代码/A 自己写,4.x 选 B。
A. wxauto —— 微信 UI 自动化事实标准(生态最大,已冻结转商业)
背景简介
- ⭐ 7286★ · 1382 fork · Apache-2.0 · Python · 2021-08-15 创建 · 最后推送 2026-04-13(开源版冻结,README 自标 “2021-2025”)
- 仓库:https://github.com/cluic/wxauto | 官网 https://wxauto.org | 文档 https://docs.wxauto.org
- 定位:Windows 微信客户端(非网页版)UIAutomation 自动化库,发消息、收消息、简单机器人——本领域 star 最多、下游生态最大的”事实标准”
怎么用·依赖·配置·上手难度(低)
- 环境:Windows 10/11/Server2016+ · 微信 3.9.X(需降级安装指定版本,README 附百度网盘)· Python 3.9+
pip install wxauto(公共 PyPI 包已停更,现走官网/文档渠道分发);几行代码即可发消息、监听新消息- 上手极低:初始化 WeChat 对象 → SendMsg/Listen,中文文档和教程全网最多
核心能力
- 发送文本/图片/文件、@群成员、监听新消息、获取会话列表与联系人、自动回复示例
- 大量下游生态(见文末”wxauto 生态”):HTTP API 封装、管理面板、群聊 AI 总结、AstrBot 桥接等
对用户的价值
- 教程最全、踩坑资料最多,微信 3.9.x 下五分钟跑通自动回复
- 纯 UI 自动化(不注入、不碰协议),封号风险在所有路线里最低
能力边界
- ❌ 只支持微信 3.9.x:4.x 自绘渲染后 UIA 树失效,官方 wxauto4 适配尝试已标”停止更新”
- ❌ 开源版冻结:作者重心转向付费版 wxautox(专业版 pip 包月下载 764,付费解锁)
- ⚠️ README 免责声明”禁止用于实际生产项目和商业用途”
- ⚠️ PyPI 公共包月下载仅 135 次、issue 区最新一条停留在 2024-12——社区已迁移,靠存量教程续命
B. wechatauto-replica —— 微信 4.x 接班者(DB 解密 + UIA/OCR 混合)
背景简介
- ⭐ 134★ · 月下载 6882(PyPI 实测) · Apache-2.0 · Python · 2026-08-07 创建 · 极活跃(2026-08-30 当天发 v1.2.0,一周内 5 个 release)
- 仓库:https://github.com/fanyuantaier/wechatauto-replica
- 定位:wxauto 的 微信 4.x 兼容替代品(drop-in 风格):经典 wxauto 依赖的 UIA 树被 4.x 抛弃后,本项目改用”读消息走本地 SQLCipher4 数据库解密,发消息走 UIA + OCR 混合驱动(自动降级)“
怎么用·依赖·配置·上手难度(中)
- 环境:Windows 10/11 · 微信 4.1.12+ · Python 3.9+(3.12 验证)·
pip install wechatauto-replica - 读消息/导历史无需额外操作(直接读
xwechat_files/.../db_storage/加密库);发送路径可选装 OCR 依赖(winsdk + pypinyin) - 提供 GUIDE.md 双语使用指南,API 风格对 wxauto 用户友好
核心能力
- 实时消息监听(增量轮询 + 每会话工作线程)、表情消息截图捕获
- 全量历史导出(JSON/SQLite)、媒体下载(图片 v2 AES 解密、SILK 语音、原图触发下载)
- 朋友圈读取(直接读 sns.db,README 称 3382 条 feed 实测)、多账号管理
- 发送:文本/文件/图片/引用回复/@成员;语音通话、拍一拍(UIA 按钮 + OCR 菜单兜底)
- UIA 树热激活:向 Weixin.dll 写入 Qt 无障碍开关后也能用标准 UIA
对用户的价值
- 当前唯一活跃维护、功能完整的微信 4.x 自动化开源方案,且是 PyPI 实际下载量最大的本领域包
- 读(DB 解密,稳定全量)+ 发(UIA/OCR,拟人)混合架构,绕开了 4.x 无障碍树缺失的死局
能力边界
- ❌ 太新:2026-08 才创建、2 位贡献者、单人主导,长期维护风险未知
- ⚠️ 读消息本质是数据库解密——依赖本机登录态可拿到密钥,属于”本地数据分析”边界玩法
- ⚠️ 发送走坐标 + OCR 兜底,稳定性受分辨率/主题/弹窗干扰影响
- ⚠️ star 少(134),社区沉淀尚薄,遇坑主要靠 issue 直连作者
C. WeChatBot_WXAUTO_SE —— 成品”微信AI自动回复”应用(已停更,最佳模板)
背景简介
- ⭐ 879★ · Python · 基于 wxauto(收发)+ LLM API 聚合(大脑)· v3.25.1 · README 首行即【停止维护】
- 仓库:https://github.com/iwyxdxl/WeChatBot_WXAUTO_SE (改自 KouriChat 生态,上游 KouriChat 3239★)
- 定位:开箱即用的微信 AI 自动回复/陪伴机器人成品——UI 自动化路线里功能清单最全的完整应用
怎么用·依赖·配置·上手难度(中)
- 微信 3.9.x + Python + 自备任意 LLM API(聚合多模型);WebUI 完成启动/改配置/管理 Prompt
- 作为应用直接部署可用;更适合当模板抄:把它的监听/回复/记忆框架嫁接到自己的代码上
核心能力
- 智能自动回复:多用户/群聊并发,每用户或群聊独立 Prompt
- 图片与表情包识别、情绪识别并回表情包、消息内链接网页内容获取、联网搜索
- AI 时间感知(年月日星期时分秒)、主动发消息、多条消息合并处理
- 记忆功能:AI 总结聊天记录存入 Prompt 或独立核心记忆文件
- 定时任务(”15 分钟后提醒我出门””每天早上六点叫我起床”,支持语音通话提醒)
- 前端 WebUI;接收语音消息
对用户的价值
- 想快速拥有”微信小号=AI 女友/客服”的完整参考实现,功能设计可直接借鉴
- 所有”AI 自动回复产品”该有的细节(独立人设、记忆、主动消息、情绪)都已实现过一遍
能力边界
- ❌ 已停止维护(明确声明),issue 不再处理
- ❌ 上游 KouriChat 明确【禁止接入微信、QQ 等腾讯系软件】——法律与合规态度暧昧
- ⚠️ 依赖 wxauto,仅支持微信 3.9.x;⚠️ 项目声明仅供学习 LLM 交流,勿用于生产
D. WeChatAuto.SDK —— .NET 生态微信 RPA SDK(新旧版本通吃)
背景简介
- ⭐ 255★ · MIT · C#/.NET 6+(附官方 Python SDK,要求 Python 3.13+)· 2026-08-30 当天仍在提交
- 仓库:https://github.com/scottfly189/WeChatAuto.SDK
- 定位:面向 AI 集成场景的微信 RPA 自动化框架,基于 .NET UI 自动化技术,同时兼容微信 3.9.12.x 与 4.1.11.x 并持续适配新版
怎么用·依赖·配置·上手难度(中)
- .NET 6+ 环境(NuGet 引入),或用官方 Python SDK(3.13+)跨语言调用
- 支持”纯软件自动化”与”硬件键鼠模拟器”双方案,按业务风险等级选择更稳妥的执行方式
核心能力
- 消息:发文字/表情/文件、@提醒、转发、消息监听
- 社交:群管理、朋友圈操作、通讯录管理
- 架构:多微信实例管理 + 分布式(WebSocket 长连接,一台应用控制多台机器的多微信)
- 重要接口均覆盖单元测试
对用户的价值
- .NET 技术栈下几乎唯一的微信自动化选择;新旧版本通吃且在持续适配
- 多实例+分布式设计适合需要同时挂多个小号的业务形态(如客服矩阵)
能力边界
- ⚠️ 80% 开源(20% API 属 VIP 独有),深度功能需付费
- ⚠️ 项目年轻(255★)、社区小,文档以视频+中文为主
- ⚠️ Python 侧要求 3.13+,对环境有额外要求
E. wechat-automation-api —— 给 AI Agent 用的”发微信” Skill
背景简介
- ⭐ 171★ · 41 fork · 未声明 License · 2025-10-31 创建 · 2026-06-01 推送
- 仓库:https://github.com/LAVARONG/wechat-automation-api
- 定位:微信 Windows 版自动化发送服务(支持 4.0+):Flask + uiautomation 封装成 HTTP API,核心卖点是Agent Skill 入口——用自然语言指挥智能体发微信
怎么用·依赖·配置·上手难度(低)
- 三种入口:Skill(推荐,”请帮我安装部署这个 skill…”一句指令让智能体自己装好并试发)、CLI(单次执行即退)、HTTP API(Flask 后台,适合外部系统长期集成/批量/队列)
- 环境:Windows 10/11 · Python 3.7+ · 微信 PC 端已登录
- 不使用 Hook、不接入微信协议,只操作本机微信窗口
核心能力
- 发送文本、图片 URL、本地文件
- 自然语言玩法示例:查新闻→整理→发到指定联系人;下载图片→转发;报告 xlsx→发送
- 与 ZCode/Codex 这类 Agent 工作流天然契合(SKILL.md 标准格式)
对用户的价值
- “AI 主动给我发消息”场景的最快实现:让 Agent 把任务结果、监控告警、日报通过微信推送到手机
- 支持 4.0+,无需降级微信
能力边界
- ❌ 只发不收:没有消息监听/自动回复能力,做不了完整客服闭环
- ⚠️ 未声明 License(默认保留所有权利),商用需联系作者
- ⚠️ 171★ 小项目,单人维护
📊 五者对比总结
| 维度 | A. wxauto | B. wechatauto-replica | C. WXAUTO_SE | D. WeChatAuto.SDK | E. wechat-automation-api |
|---|---|---|---|---|---|
| 形态 | Python 库 | Python 库 | 成品应用 | .NET SDK | Skill/CLI/HTTP |
| 微信版本 | 3.9.x | 4.1.12+ | 3.9.x | 3.9.12.x+4.1.11.x | 4.0+ |
| 收+发闭环 | ✅ | ✅ | ✅(应用级) | ✅ | ❌ 只发 |
| 星标 | 7286 | 134 | 879 | 255 | 171 |
| 实际热度 | 官网分发+存量教程 | PyPI 6882/月 | 模板被大量fork | 当日仍在提交 | 中 |
| 维护状态 | 🔴 冻结转商业 | 🟢 当日发版 | 🔴 停更 | 🟢 活跃(80%开源) | 🟡 维护中 |
| 技术路线 | 纯 UIA | DB解密+UIA/OCR | wxauto+LLM | UIA+硬件模拟 | 纯 UIA |
| 二次开发自由度 | 高 | 高 | 中(抄代码) | 高(20% VIP) | 高 |
怎么选:
- 微信已升级 4.x、Python 技术栈、要完整收发 → wechatauto-replica(唯一活跃的 4.x 方案,接受其年轻风险)
- 愿意锁死微信 3.9.x、要最多教程 → wxauto(接受冻结与免责条款)
- 要现成 AI 自动回复成品/找实现模板 → 抄 WXAUTO_SE 代码(不建议原样上线:停更+上游禁微信)
- .NET 技术栈 / 多号矩阵 / 风控敏感 → WeChatAuto.SDK
- 只要 AI 主动推送消息(日报/告警/任务结果) → wechat-automation-api
- 商用稳定优先 → 不碰个人微信自动化,走企业微信/公众号官方接口(CowAgent 等框架的官方通道)
社区反馈与可靠性
- wxauto:7286★ 为本领域最高,但 2025 年冻结、作者转商业 wxautox;公共 PyPI 月下载仅 135、issue 区 2024-12 后停滞——存量价值高、增量投入归零。教程多是其最大资产
- wechatauto-replica:star 仅 134 但 PyPI 月下载 6882(远超 wxauto 公共包),一周 5 个 release——真实需求旺盛的新晋方案;风险是单人项目、历史太短
- WeChatBot_WXAUTO_SE:879★,停止维护且上游 KouriChat 明确禁止接入微信;但作为功能最全的成品模板,代码被大量参考——参考价值 > 部署价值
- WeChatAuto.SDK:2026-08-30 仍在提交,MIT + 80% 开源(20% VIP API),主力单人开发;年轻但节奏健康
- wechat-automation-api:171★,维护中;无 License 是商用硬伤
- 大局观:两大 hook 项目 WeChatFerry(6797★)与 NGCBot(3302★)双双归档,wcferry Python 包仍有 6340 月下载的存量使用;JS 侧由 wechatferry 组织(2079★)接棒并给 Wechaty 提供”免费 PC Hook puppet”。hook 路线退潮、UI 自动化/DB 解密混合成为个人微信自动化的主流方向
- 避坑:easyChat(搜索索引显示 1478★)实测仓库已 404(删库/转私有),不要再找它;WeChatPYAPI(1053★)社区版锁死微信 3.6.0.18 且不再维护,实为付费专业版引流,不建议
📌 未来微信自动化规划(入口)
- 短期:微信 UI 自动化项目统一收在此文件(五项目对比)
- 可选:跟进 wechatauto-replica 稳定性(若持续维护可升级为主力方案);商用客服场景另起一篇调研企业微信官方接口路线
refer
- https://github.com/cluic/wxauto
- https://github.com/cluic/wxauto4 (已停止更新)
- https://github.com/fanyuantaier/wechatauto-replica
- https://github.com/iwyxdxl/WeChatBot_WXAUTO_SE
- https://github.com/KouriChat/KouriChat
- https://github.com/scottfly189/WeChatAuto.SDK
- https://github.com/LAVARONG/wechat-automation-api
- https://github.com/lich0821/WeChatFerry (已归档)
- https://github.com/wechatferry/wechatferry
- https://github.com/jingyi0605/WXAUTO-HTTP-API | https://github.com/jingyi0605/WXAUTO-MGT
- pypistats.org(wxauto/wxautox/wcferry/wechatauto-replica 月下载量实测)
声明:
若文章存在错误,望诸君不吝指正^
blog 仅供个人记录学习所用
部分笔记由于年代久远,做的笔记找不到最初是引用谁的,若是不允许引用转载,请联系我
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 晚上十一点睡觉のBlog!
评论











