WeChatFerry

Hook 微信 PC 端，轻松接入大模型做机器人

WeChatFerry 是一个基于 Windows 微信 PC 客户端的 Hook 工具，通过注入技术操作微信内部接口，实现对微信消息的收发、联系人管理、群操作等自动化控制。它解决了个人或小团队无法便捷地将微信与外部程序（如大模型）对接的问题，核心能力包括消息监听与回复、群成员管理、数据库访问等。项目提供 Python、C++ 等语言的 SDK，开发者可基于它快速构建微信机器人，并接入 DeepSeek、ChatGPT、Gemini 等主流大模型，实现智能对话、自动客服、群管理等功能。它本质是一个底层通信层，上层应用完全由开发者自定义，灵活度高。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6797

维护状态维护中

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队lich0821

所属国家

官网地址

GitHubhttps://github.com/lich0821/WeChatFerry

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言C++

技术栈/模型chatglm,chatgpt,gemini,hook,robot,wechat

GitHub 星标★ 6797

30天Star增速

HF 下载量

上线时间2022-09-20 00:00:00

最近更新2026-09-22 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 20 分钟部署方式：库/依赖 7 步

环境要求

Windows 系统（需配合微信 PC 客户端）
Python 3.x，建议 3.10（版本过高需自行编译依赖）
编译源码需安装 VS2019 与 vcpkg
需自行准备微信 PC 客户端环境

安装与启动步骤

1准备 Python 环境

通过微软商店或 python.org 安装 Python，建议 3.10，并配置好环境变量，确保命令行里 python 可用。
2安装 wcferry

在命令行中安装 WeChatFerry 的 Python 包，升级到最新版本后即可在代码中导入使用。
```
pip install --upgrade wcferry
```
3参考机器人示例

官方提供了基于 WeChatFerry 的 Python 机器人示例 WeChatRobot，可对照它了解消息收发等接口用法。
4安装 vcpkg

仅编译源码时需要。进入 C:Tools 目录克隆 vcpkg 并执行 bootstrap 脚本完成安装。
```
cd C:Tools
git clone https://github.com/microsoft/vcpkg
.cpkgootstrap-vcpkg.bat
```
5配置 vcpkg 环境变量

把 vcpkg 所在路径写入全局环境变量 VCPKG_ROOT，示例路径为 C:/Tools/vcpkg。
```
setx VCPKG_ROOT "C:/Tools/vcpkg" /M
```
6集成 Visual Studio

执行 vcpkg integrate install 与 VS 集成；若失败说明未正确安装或未正确配置环境变量。
```
vcpkg integrate install
```
7安装编译依赖

若需要从源码编译，安装 grpcio-tools 指定版本；其余组件在编译时会自动安装。
```
pip install grpcio-tools==1.48.2
```

关键配置

配置项	必填	说明	示例
`VCPKG_ROOT`	是	指定 vcpkg 安装路径，供编译时查找依赖	`C:/Tools/vcpkg`
`protoc.exe 环境变量`	否	需手动使用 protoc.exe 时，将其所在 toolsprotobuf 目录加入环境变量	`C:ProjsWeChatFerryWeChatFerrycpkg_installedd-windows`

如何确认成功

命令行中 python 可正常使用，且 pip install --upgrade wcferry 执行无报错，即表示安装成功。

常见问题

Q：只有 Python 一种接入方式吗？

A：不是。README 列出的客户端支持 Python、HTTP、NodeJS，另有 Java 客户端以及 wcfrust、go_wcf_http、wrest-chat 等第三方 HTTP 实现。

Q：可以用 Docker 部署吗？

A：README 未提供官方 Docker 命令，只列出了第三方方案 docker_wechat 与 wechatbot-provider-windows，需要自行前往对应仓库查看用法。

Q：pip 安装依赖时报错怎么办？

A：README 提示 python 版本不能太高，否则需自行编译依赖，建议使用 Python 3.10 后重试。

Q：编译时提示找不到 vcpkg？

A：检查 VCPKG_ROOT 环境变量是否已正确设置（README 示例为 C:/Tools/vcpkg），配置后重新执行 vcpkg integrate install。

注意事项

README 中的免责声明为必读内容，使用前请阅读完整的 DISCLAIMER
本项目基于 Windows 微信 PC 客户端注入，需自行准备可用的客户端环境
WeChatFerry 只是底层通信层，上层机器人逻辑完全由开发者自定义
README 未给出的命令、端口和参数不要臆测，请以官方文档与示例仓库为准

核心亮点

提供 Python/C++ SDK，接口清晰，上手快
支持多主流大模型接入，生态适配广
消息收发、群管、数据库操作等能力全面

不足之处

仅支持 Windows 微信 PC 客户端，跨平台受限
依赖微信版本，更新后可能失效，维护成本高
文档/社区待观察

适用场景

个人微信自动化助手，如自动回复、定时提醒
企业微信群管理，如入群欢迎、关键词回复
基于大模型的智能客服或聊天机器人

替代项目

itchat、wechaty、wxpy

项目介绍

WeChatFerry 是智能体领域的开源项目，由 lich0821 开发，2022 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（6,797）位列前 7%，在智能体分类的 2,499 个项目里位列前 7%。

项目仍在小幅维护中，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：个人微信自动化助手，如自动回复、定时提醒。同类可对比的替代方案包括 itchat、wechaty、wxpy。

上一篇：chatgpt2codex

下一篇：awesome-codex-subagents