wx4py

你是否还在为每天重复的微信操作头疼？

• 🔁 群发通知：手动一个个群复制粘贴，累且容易漏。
• 📁 文件分发：同一个文件要在 10 个群里上传，拖拽到手软。
• ⏰ 定时提醒：想每天下午 5 点催日报，微信却没这功能。
• 📊 数据分析：想统计群活跃度，却没法导出聊天记录。
• 🤖 AI 联动：想让 AI 帮你管微信，却找不到合适的接口。

wx4py 是一个专为 微信 Windows 版 4.x 打造的 Python 自动化库。它不注入 DLL，不修改客户端，而是通过模拟真实用户操作（UI Automation），让你用几行代码轻松掌控微信。

核心功能一览

1. 一句话群发通知

告别手动复制粘贴，一键触达所有群组。

from wx4py import WeChatClient

with WeChatClient() as wx:
    wx.chat_window.batch_send(
        ["技术部", "产品部", "运营部"],
        "【通知】明天下午3点全员会议，请准时参加。",
        target_type='group'
    )

2. 定时自动任务

结合 schedule 库，让微信变成你的定时闹钟。

import schedule
from wx4py import WeChatClient

def daily_remind():
    with WeChatClient() as wx:
        wx.chat_window.batch_send(
            ["研发一组", "研发二组"],
            "【提醒】下班前请提交今日日报！",
            target_type='group'
        )

# 每天下午 5 点执行
schedule.every().day.at("17:00").do(daily_remind)

while True:
    schedule.run_pending()

3. 文件批量分发

一份周报，瞬间同步到所有相关部门。

with WeChatClient() as wx:
    file_path = r"C:\Reports\weekly_report.pdf"
    for group in ["技术部", "产品部", "市场部"]:
        wx.chat_window.send_file_to(group, file_path, target_type='group')

4. 聊天记录导出与分析

将聊天记录转化为 CSV，用 Pandas/Excel 进行深度分析。

import pandas as pd
from wx4py import WeChatClient

with WeChatClient() as wx:
    # 获取本周聊天记录
    messages = wx.chat_window.get_chat_history(
        "项目讨论组", 
        target_type='group', 
        since='week'
    )
    
    # 导出为 CSV
    df = pd.DataFrame(messages)
    df.to_csv("project_chat.csv", index=False)
    
    # 简单统计
    print(df['type'].value_counts())

5. 群管理全能助手

批量修改公告、设置免打扰、置顶重要群。

with WeChatClient() as wx:
    # 批量更新公告
    for group in ["项目A", "项目B", "项目C"]:
        wx.group_manager.modify_announcement_simple(
            group, 
            "本周重点：完成核心模块开发，周五验收。"
        )
    
    # 设置免打扰
    wx.group_manager.set_do_not_disturb("摸鱼群", enable=True)
    
    # 置顶聊天
    wx.group_manager.set_pin_chat("老板群", enable=True)

AI 原生集成：说话即操作

不想写代码？wx4py 完美支持 Claude Code 和 OpenClaw。
只需告诉 AI 你的需求，它会自动生成并执行代码。

示例对话：

你: “帮我给文件传输助手发一条消息：测试成功，然后给‘技术部’群发一份位于 D:\doc.pdf 的文件。”

AI (自动执行):

1. 调用 wx.chat_window.send_to("文件传输助手", "测试成功")
2. 调用 wx.chat_window.send_file_to("技术部", r"D:\doc.pdf", target_type='group')
3. 回复你：“已完成！消息已发送，文件已上传至技术部群。”

安装 AI Skill:
在 Claude Code 中运行：

安装并使用 wx4py skill。
技能地址：https://raw.githubusercontent.com/claw-codes/wx4py/main/wx4-skill/SKILL.md

快速开始

1. 环境要求

• 系统: Windows 10 / 11
• Python: 3.9+
• 微信: 微信 Windows 版 4.x (已测试版本：4.1.7.59, 4.1.8.29)
  • 注意：不支持 Mac 版或旧版 3.x

2. 安装

pip install wx4py

3. 第一个脚本

确保微信已登录并在前台运行，保存以下代码为 test.py 并运行：

from wx4py import WeChatClient

with WeChatClient() as wx:
    wx.chat_window.send_to("文件传输助手", "wx4py 连接成功！🎉")
    print("消息已发送！")

❓ 常见问题 (FAQ)

Q: 需要保持微信窗口在前台吗？

A: 是的。由于采用 UI 模拟技术，操作时微信窗口需要可见且未被最小化。建议在专用显示器或空闲时段运行自动化脚本。

Q: 能获取消息发送者的名字吗？

A: 暂时不能。受限于微信 4.x 的 UI 结构，目前无法从界面上直接提取群消息的具体发送者昵称，只能获取消息内容和类型。这是技术限制，未来若微信 UI 变更可能会支持。

Q: 会被封号吗？

A: wx4py 模拟的是真实用户的鼠标键盘操作，不注入进程、不修改内存，风险远低于协议类机器人。但为了安全起见：

• 请控制发送频率，避免瞬间大量群发。
• 不要用于发送营销垃圾信息。
• 建议先用小号测试。

Q: 支持哪些微信版本？

A: 仅支持 微信 Windows 版 4.x。

• ✅ 已测试：4.1.7.59, 4.1.8.29
• ❌ 不支持：Mac 版、Linux 版、旧版 3.x、企业微信（需等待单独支持）。

为什么选择 wx4py？

wx4py 让微信自动化不再是黑客的专利，而是每个办公族都能掌握的效率工具。
立即安装，释放你的双手！