要监听某个群里的新消息
你关心的不是一次发送,而是这个群什么时候来了新消息、有没有人 @ 你、后续是否要继续处理。
wx4py 可以:为指定群打开独立监听窗口,持续接收新消息事件,适合告警群、值班群和运营群。
微信 4.x 自动化 · OpenClaw / 龙虾集成
wx4py 把群聊机器人、微信群发、自动发文件、批量改群公告、聊天记录导出这些重复操作收拢成一个可靠的 Windows 工具。 你可以写 Python,也可以直接让 OpenClaw 或 Claude Code 用自然语言帮你执行。
pip install wx4py
from wx4py import WeChatClient
with WeChatClient() as wx:
wx.chat_window.send_to("文件传输助手", "测试成功")
视频演示
如果你想先看看 wx4py 和 OpenClaw 的实际操作流程,可以直接播放下面这段演示视频。
真实痛点
你关心的不是一次发送,而是这个群什么时候来了新消息、有没有人 @ 你、后续是否要继续处理。
wx4py 可以:为指定群打开独立监听窗口,持续接收新消息事件,适合告警群、值班群和运营群。
比如告警群里的新消息要同步给值班同学,或者项目群 A 的动态要转到项目群 B。
wx4py 可以:监听群消息后自动转发给指定联系人或另一个群,适合值班转发、消息同步和简单路由。
群里消息很多,但你不希望机器人每条都回,只想在明确被点名时再处理。
wx4py 可以:结合 AI 接口做 @ 触发自动回复,普通消息只监听不打扰。
手工复制、切换会话、反复上传并不难,但非常耗时,而且容易漏发或发错。
wx4py 可以:发消息、批量发送、发文件都已封装好,适合通知、资料分发和日常提醒。
项目群、部门群和值班群经常要同步公告,或者统一调整免打扰、置顶状态。
wx4py 可以:读取群成员、获取群昵称、修改公告、设置免打扰和置顶,覆盖常见群管理操作。
很多团队一开始只想要 Python 能跑,后面再考虑接 OpenClaw、Claude Code 或其他 AI 工具。
wx4py 可以:既保留清晰的 Python API,也方便后续接入自然语言操作,不需要一开始就押注某种工作流。
为什么用起来顺手
这部分不重复列功能,而是说明为什么它适合拿来写脚本、做群机器人或接入自然语言工具。
定位明确,直接服务 Windows 桌面端微信 4.x,不是泛泛而谈的聊天自动化方案。
群消息监听、转发和自动回复统一走 process_groups(),组合场景不需要再拆成多套接口。
你可以直接用 Python 调 API,也可以再接 OpenClaw、Claude Code 或兼容 OpenAI 接口的模型服务。
支持多个群独立窗口监听、消息转发和 @ 触发回复,适合值班、运营、同步和群助手类需求。
转发和 AI 回复最终走统一发送队列,减少窗口抢占、串消息和误发到错误会话的风险。
README、接口文档和示例都按真实任务组织,先改顶部常量再运行,不需要先理解一堆内部细节。
快速开始 / OpenClaw 集成
wx4py 最适合的上手方式不是先写脚本,而是先把 skill 安装好。按 README 中的提示把下面这段话直接发给 OpenClaw,后续就可以用自然语言执行微信 4.x 自动化操作。
安装并使用 wx4py skill。
技能地址:https://raw.githubusercontent.com/claw-codes/wx4py/main/wx4-skill/SKILL.md
1、执行命令 pip install wx4py 安装所需库。
2、将 wx4py skill 安装至本地的 skills 目录,并在工具文档和记忆系统中记录该技能。
3、阅读 skill 文档后,向我说明如何与你进行对话以使用该技能。
安装后可以直接这样说
“帮我给文件传输助手发一条消息:测试成功”
如果你只是想先验证有没有跑通,这条指令最直接,也最容易看出效果。
帮我给文件传输助手发一条消息:测试成功
环境与限制
FAQ
wx4py 模拟的是桌面端真实操作,不修改微信客户端。但依然建议控制发送频率,避免大量群发营销内容,并先用非重要账号测试。
当前面向微信 4.x,已测试版本包括 4.1.7.59 和 4.1.8.29。
是。执行操作时,微信窗口需要在前台,这是当前自动化方式的前提。
暂时不能。微信 4.x 当前暴露的界面信息不包含发送者字段,因此聊天记录暂时无法拿到发送者信息。
开始使用
如果你的日常工作里经常要微信群发、重复发文件或同步改公告,wx4py 值得试一次。