WeChatFerry
Hook 微信 PC 端，轻松接入大模型做机器人
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6804
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- 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 .\vcpkg\bootstrap-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 时，将其所在 tools\protobuf 目录加入环境变量 | C:\Projs\WeChatFerry\WeChatFerry\vcpkg_installed\x64-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
上一篇：chatgpt2codex
同类项目推荐
polymarket-mcp-server
开源
让 Claude 直接查行情、下单、盯仓位，玩转 Polymarket
AI-Powered MCP Server for Polymarket - Enable Claude to trade prediction markets wit···
SimpleMem
开源
给LLM智能体装上长效记忆，让对话和任务不再失忆。
[ICML'26] SimpleMem: Efficient Lifelong Memory for LLM Agents — Text & Multimodal
switch
开源
把任意 AI Agent 接进 Slack/Teams/Discord，自托管开箱即用
Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-hos···
superset
开源
一个界面同时指挥多个 AI 编程代理，告别混乱切换
Paradev is an open-source Codex App and Conductor alternative. Orchestrate an army c···
ehForwarderBot
开源
一个框架，打通所有聊天平台，消息互转远程控号。
An extensible message tunneling chat bot framework. Delivers messages to and from mu···
awesome-autonomous-gpt
开源
一站式导航，快速上手自主AI智能体开发
A curated list of awesome projects and resources related to autonomous AI agents.
fennara-godot-ai
开源
在 Godot 里直接聊 AI，连 MCP 代理，开发效率翻倍
AI chat and agent tooling for Godot, with both MCP support and in-built native chat ···
hippo-memory
开源
给 AI 智能体装上会遗忘、会强化的类脑记忆
Stop re-teaching your agent. Make your agent's memory work like a brain. Hippo is lo···
customizable-gpt-chatbot
开源
用大白话聊出你的 AI 智能体，越用越聪明
Veldra — talk an agent into existence, then watch it grow. A self-hostable, local-f···