微信机器人，可接入DeepSeek、Gemini、ChatGPT、ChatGLM、讯飞星火、Tigerbot等大模型。微信 hook WeChat Robot Hook.
C++
6,805
1,065 commits
updated Jul 10, 2026
一个玩微信的工具。更多介绍见：WeChatFerry: 一个玩微信的工具。
请阅读完整的免责声明：点击查看
👉 WeChatRobot🤖，一个基于 WeChatFerry 的 Python 机器人示例。
pip install --upgrade wcferry
🚫 非开发用户不需要往下看。
开发用户：可以根据文档和错误提示，自行解决编译错误的人员。
cd C:\Tools
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat
vcpkg 所在路径（本文为：C:\Tools\vcpkg）：setx VCPKG_ROOT "C:/Tools/vcpkg" /M
vcpkg integrate install # 失败则说明未正确安装或者未正确配置环境变量
编译时会自动安装。但如果需要使用 protoc.exe，则需要配置一下 protoc.exe 环境变量：<vcpkg_package_installed_path>\x64-windows-static\x64-windows-static\tools\protobuf。
（本文为：C:\Projs\WeChatFerry\WeChatFerry\vcpkg_installed\x64-windows-static\x64-windows-static\tools\protobuf）
通过微软商店或者 python.org 自行下载均可（注意 python 版本不能太高，否则需要自行编译依赖，建议使用 python 3.10），然后配置好环境变量，确保 python 在命令行下可用。
安装依赖：
pip install grpcio-tools==1.48.2
使用 VS2019 打开工程，编译即可。编译成功后，在 WeChatFerry\WeChatFerry\Out 目录中会看到相应的 DLL 文件。
注：如果遇到执行 protoc 时的 9009 错误，检查是否是 python3 环境有问题，或者 protoc 命令的环境变量配置不正确。
import ctypes
# 加载 sdk.dll （需要绝对路径）
sdk = ctypes.cdll.LoadLibrary("C:/Projs/WeChatFerry/WeChatFerry/Out/sdk.dll")
# 初始化
sdk.WxInitSDK(False, 10086)
# 退出 SDK
sdk.WxDestroySDK()
# 注意关闭 Python 进程
util::dbg_msg("ListenMessage"); // 封装的 OutputDebugString
OutputDebugString(L"ListenMessage\n");
MessageBox(NULL, L"ListenMessage", L"ListenMessage", 0);
WeChatFerry
├── LICENSE # LICENSE
├── README.MD # 说明
├── WeChatFerry
│ ├── WeChatFerry.sln # VS2019 工程文件
│ ├── com # 公共模块
│ ├── rpc # RPC 模块
│ ├── sdk # 注入及启动模块
│ ├── smc # Silk-Mp3 转换模块
│ └── spy # 核心功能实现模块
├── assets
│ ├── QR.jpeg # 二维码，测试用图
│ ├── TEQuant.jpg # 二维码，测试用图
│ └── demo.gif # 示例动图
├── clients
│ ├── go # Go 客户端
│ ├── gohttp # HTTP 客户端
│ ├── http # HTTP 客户端
│ ├── java # Java 客户端
│ ├── node # Node.js 客户端
│ ├── pyauto # 群友封装的客户端
│ ├── python # Python 客户端
│ └── rust # Rust 客户端
└── docs # 文档
客户端越来越多了，版本号开始混乱，所以重新定义了版本号：w.x.y.z。
其中：
w 是微信的大版本号，如 37 (3.7.a.a), 38 (3.8.a.a), 39 (3.9.a.a)x 是适配的微信的小版本号，从 0 开始y 是 WeChatFerry 的版本，从 0 开始z 是各客户端的版本，从 0 开始3.9.12.51。3.9.12.17。3.9.11.253.9.10.273.9.10.191,718 followers · starred Sep 2024
591 followers · starred Mar 2025
7 followers · starred Jan 2024
587 followers · starred Feb 2025
微信机器人，可接入DeepSeek、Gemini、ChatGPT、ChatGLM、讯飞星火、Tigerbot等大模型。微信 hook WeChat Robot Hook.
C++
6,805
1,065 commits
updated Jul 10, 2026
一个玩微信的工具。更多介绍见：WeChatFerry: 一个玩微信的工具。
请阅读完整的免责声明：点击查看
👉 WeChatRobot🤖，一个基于 WeChatFerry 的 Python 机器人示例。
pip install --upgrade wcferry
🚫 非开发用户不需要往下看。
开发用户：可以根据文档和错误提示，自行解决编译错误的人员。
cd C:\Tools
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat
vcpkg 所在路径（本文为：C:\Tools\vcpkg）：setx VCPKG_ROOT "C:/Tools/vcpkg" /M
vcpkg integrate install # 失败则说明未正确安装或者未正确配置环境变量
编译时会自动安装。但如果需要使用 protoc.exe，则需要配置一下 protoc.exe 环境变量：<vcpkg_package_installed_path>\x64-windows-static\x64-windows-static\tools\protobuf。
（本文为：C:\Projs\WeChatFerry\WeChatFerry\vcpkg_installed\x64-windows-static\x64-windows-static\tools\protobuf）
通过微软商店或者 python.org 自行下载均可（注意 python 版本不能太高，否则需要自行编译依赖，建议使用 python 3.10），然后配置好环境变量，确保 python 在命令行下可用。
安装依赖：
pip install grpcio-tools==1.48.2
使用 VS2019 打开工程，编译即可。编译成功后，在 WeChatFerry\WeChatFerry\Out 目录中会看到相应的 DLL 文件。
注：如果遇到执行 protoc 时的 9009 错误，检查是否是 python3 环境有问题，或者 protoc 命令的环境变量配置不正确。
import ctypes
# 加载 sdk.dll （需要绝对路径）
sdk = ctypes.cdll.LoadLibrary("C:/Projs/WeChatFerry/WeChatFerry/Out/sdk.dll")
# 初始化
sdk.WxInitSDK(False, 10086)
# 退出 SDK
sdk.WxDestroySDK()
# 注意关闭 Python 进程
util::dbg_msg("ListenMessage"); // 封装的 OutputDebugString
OutputDebugString(L"ListenMessage\n");
MessageBox(NULL, L"ListenMessage", L"ListenMessage", 0);
WeChatFerry
├── LICENSE # LICENSE
├── README.MD # 说明
├── WeChatFerry
│ ├── WeChatFerry.sln # VS2019 工程文件
│ ├── com # 公共模块
│ ├── rpc # RPC 模块
│ ├── sdk # 注入及启动模块
│ ├── smc # Silk-Mp3 转换模块
│ └── spy # 核心功能实现模块
├── assets
│ ├── QR.jpeg # 二维码，测试用图
│ ├── TEQuant.jpg # 二维码，测试用图
│ └── demo.gif # 示例动图
├── clients
│ ├── go # Go 客户端
│ ├── gohttp # HTTP 客户端
│ ├── http # HTTP 客户端
│ ├── java # Java 客户端
│ ├── node # Node.js 客户端
│ ├── pyauto # 群友封装的客户端
│ ├── python # Python 客户端
│ └── rust # Rust 客户端
└── docs # 文档
客户端越来越多了，版本号开始混乱，所以重新定义了版本号：w.x.y.z。
其中：
w 是微信的大版本号，如 37 (3.7.a.a), 38 (3.8.a.a), 39 (3.9.a.a)x 是适配的微信的小版本号，从 0 开始y 是 WeChatFerry 的版本，从 0 开始z 是各客户端的版本，从 0 开始3.9.12.51。3.9.12.17。3.9.11.253.9.10.273.9.10.191,718 followers · starred Sep 2024
591 followers · starred Mar 2025
7 followers · starred Jan 2024
587 followers · starred Feb 2025