WeChatFerry 教程:3 步搭建一个能接大模型的微信机器人
【免费下载链接】WeChatFerry微信机器人,可接入DeepSeek、Gemini、ChatGPT、ChatGLM、讯飞星火、Tigerbot等大模型。微信 hook WeChat Robot Hook.项目地址: https://gitcode.com/GitHub_Trending/we/WeChatFerry
想让微信自己回消息?WeChatFerry 是一款通过 hook(往运行中的程序注入代码、拦截它的事件)来操控电脑版微信的微信机器人框架。这篇教程带你在三步内发出第一条自动回复,并接上 DeepSeek、ChatGPT 等大模型。
🧩 WeChatFerry 是干什么的:装上就能用的微信机器人框架
本质上它是一个微信 hook:把 wcfhook.dll 注入电脑版微信进程,之后你的脚本就能替它收消息、发消息。官方提供 Python、Java、C# 等多语言 SDK,Python 版门槛最低。最常用的三个能力:
- 发消息:一行
send_msg()搞定文本、图片、文件,群里 @ 人也可以 - 监听来消息:
listen_message()注册回调,消息一到函数就被调用,不用轮询 - 查联系人和群:
get_contacts()列出好友、群成员与群信息,给自动化提供数据基础
💡 为什么不自己写 hook:三个差别
- 版本对不上的事它替你做了。自己写 hook 要先找内存偏移,再跟每个微信版本对齐,升级一次就废。WeChatFerry 直接给 wcfhook.dll 和注入工具 inject.exe,你只管装公告指定的微信版本。
- 消息格式已经拆好了。文本、图片、文件各是一堆内部格式,框架封装成几个 API,直接调。
- 接大模型有现成参照。项目支持 DeepSeek、Gemini、ChatGPT、ChatGLM、讯飞星火、Tigerbot 等模型的接入,社区有大量 demo 实现,换个 API key 就能跑。
🚀 三步跑通:从注入到第一条自动回复
第一步:装好 3.9.x 版微信,下齐 hook 组件
装电脑版微信,版本必须是项目公告指定的 3.9.x 系列——hook 和微信版本不匹配,是后面一切坑的第一大来源。然后从项目 Releases 页下载 wcfhook.dll、wcferry.dll 和 inject.exe,放到微信安装同目录。
git clone https://gitcode.com/GitHub_Trending/we/WeChatFerry克隆仓库是为了拿示例代码和 Python SDK,第三步就用。
第二步:注入微信,让它能被脚本控制
管理员身份运行 inject.exe,注入完成后微信会自动启动。此时微信进程里已经跑着 hook,你的脚本和它通了。如果注入后微信起不来,九成是版本对不上,回去换对应的 DLL。
第三步:用 Python 发出第一条自动回复
在仓库目录装依赖:
pip install -r requirements.txt然后跑下面这段,"文件传输助手"会收到一条自动回复:
from wcferry import Wcf wcf = Wcf() wcf.send_msg("你好,我是自动回复", "filehelper") wcf.listen_message() # 常驻进程接收消息filehelper是"文件传输助手"的固定 wxid(微信给每个账号的内部编号)。调试阶段先拿它试,确认没问题再碰真实联系人。
🎯 拿它做三件事:客服、群管理、消息备份
怎么搭大模型问答客服
需求:你不在电脑前时,机器人替你答。
listen_message()收到消息,把内容发给 DeepSeek 或 ChatGPT 的 API- 拿到模型回复后,用
send_msg()发回给原发送者 - 群里建议只在被 @ 时触发,避免刷屏
怎么做群管理
需求:迎新、发公告不用再手动。
- 新成员进群触发回调,自动发欢迎语和群规
- 用定时器按固定时间发公告,内容模板化
怎么做消息备份与提醒
需求:重要消息不丢,待办不忘。
- 把指定联系人或群的消息自动转发到"文件传输助手",或写入本地文件存档
- 提取"记得、截止、日程"这类关键词,配合调度器次日提醒
🔧 进阶玩法:多模型怎么接、高频消息怎么处理
只展开两个值得花时间的点。
多模型路由:别把所有消息塞给一个模型。写一层简单规则:含"代码、报错、实现"的转给擅长编程的模型,文案、创意类走另一个,其余给响应快的轻量模型。规则就是一段 if-else,效果立竿见影。
高频处理:回调在 hook 线程里触发,别在里面做慢速网络请求。把消息丢进队列,主线程取出来处理;AI 请求放子线程,避免一条慢回复卡住后面的消息。同时用消息唯一 ID 做去重,防止同一条被处理两遍。
其余的定时任务、群操作、联系人管理都是现成 API,照示例代码改就行。
🛡️ 避坑与安全:版本、风控、合规
- 版本优先:hook 和微信版本是配对的,装好后别随手升级微信,必须升级就先找对应版本的 hook。
- 控制频率:高频发送容易触发微信风控。消息间隔加 1~2 秒延迟,限定每日上限,先用小号试,别碰主号。
- 合规使用:用于技术学习和效率工具,不发营销群发;消息数据只在你自己的脚本里本地处理,不外传。
- 维护状态:项目 README 已声明停止维护,部署后锁定版本,别指望后续更新,手头这套能跑的就留个备份。
❓ 常见问题:5 种症状和排查方法
| 症状 | 可能原因 | 怎么办 |
|---|---|---|
| 注入后微信起不来 | 微信与 hook 版本不匹配 | 换公告指定的微信版本,对应换 DLL |
| Python 报导入错误 | wcferry 没装好 | 在仓库目录执行 pip install -r requirements.txt |
| 发得出、收不回 | 没监听来消息 | 确认 listen_message() 在跑,核对对方 wxid |
| 微信升级后全挂 | hook 失效 | 回退微信版本,或换配套 hook |
| 账号收到封号警告 | 高频发送触发风控 | 加延迟、降频次,改用备用号 |
🏁 收尾:你的第一步
注入跑通、文件传输助手里看到自动回复之后,剩下的全是业务逻辑:监听哪些消息、接哪个模型、回复什么内容。下一步:先给"文件传输助手"发一条 send_msg,通了就配上大模型 API key,让它回你第一条真实消息。
【免费下载链接】WeChatFerry微信机器人,可接入DeepSeek、Gemini、ChatGPT、ChatGLM、讯飞星火、Tigerbot等大模型。微信 hook WeChat Robot Hook.项目地址: https://gitcode.com/GitHub_Trending/we/WeChatFerry
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考