拟人化 AI 微信机器人 wechatbot-new:基于 KouriChat 的重构,让虚拟角色在新版微信复活
拟人化 AI 微信机器人 wechatbot-new:基于 KouriChat 的重构,让虚拟角色在新版微信复活
作者:fanyuantaier | 邮箱:fanyuantaier@163.com
项目地址:https://github.com/fanyuantaier/wechatbot-new
当前版本:v2.2.0
一、项目从哪来:KouriChat 家族的"微信版"
先理一下血缘关系:
- KouriChat(原 My-Dream-Moments,版权 umaru 2025):开源的本地 AI 聊天助手框架,把用户喜爱的角色、虚拟人物、自定义人格接入聊天平台(微信/QQ 等),主打拟人化——不只是问答,而是像真人一样有人设、有记忆、有情绪。
- WeChatBot_WXAUTO(作者 iwyxdxl):在 KouriChat 基础上改造的微信版,一度在 B 站、QQ 群非常火(QQ 群总人数过万),闲鱼上甚至出现了不少"微信接入 DeepSeek 代部署"的付费服务。
- wechatbot-new(本项目,fanyuantaier 维护):原项目停止更新后接手,在上一任维护者基础上完成微信 4.x 兼容性重构的延续版本,v2.2.0。
核心痛点一句话:原版依赖的 wxautox 微信自动化底座只支持微信 3.9,UIA 路线在新版本微信上完全失效——微信 4.x 自绘渲染、不暴露无障碍节点,机器人收发消息的链路整个断掉,跑不起来。
二、重构思路:换底座,保灵魂
原版架构是"微信自动化底座 + AI 对话核心"。底座挂了,对话核心还在,所以重构不是重写,而是把失效的底座整个换掉:
重构前(只支持微信 3.9):
┌──────────────┐ ┌──────────────────────┐
│ wxautox 底座 │──▶│ AI 对话核心 │
│ (UIA 控件抓取) │ │ 人设/记忆/情绪/表情包 │
└──────────────┘ └──────────────────────┘
❌ 微信 4.x 上完全失效
重构后(支持微信 4.1.12.26):
┌──────────────────┐ ┌──────────────────────┐
│ wechatauto-replica│──▶│ AI 对话核心(保留) │
│ (数据库解密+坐标OCR)│ │ 人设/记忆/情绪/表情包 │
└──────────────────┘ └──────────────────────┘
✅ 兼容新版微信
具体做了三件事(2026 年 8 月初完成):
- 复刻底座:wxautox 已不支持最新版微信,用 opencode 复刻出 wechatauto-replica(已发布到 PyPI 和 GitHub)——读取走本地数据库解密(SQLCipher 4),发送走坐标 + OCR,绕开失效的 UIA 路线(详见上一篇);
- 重构核心代码:把机器人所有收发消息的接口全部替换为 wechatauto-replica 接口,对话逻辑、人设、记忆、情绪识别原样保留;
- 去掉版本枷锁:移除 Run.exe 里的微信版本检查(原来强绑定 4.1.6),不限微信版本,现支持 4.1.12.26 直接启动。
三、功能特性(v2.2.0)
- 🤖 智能自动回复:多用户/群聊同时聊天,每个用户或群聊可分配独立的提示词(Prompt),一人一角色;
- 🖼️ 图片和表情包内容识别:收到图片/表情包,AI 能"看懂"并回复;
- 😊 情绪识别并回复表情包:AI 分析对话情绪,从
emojis/目录按情绪分类(angry/happy/sad…)自动配发对应 GIF; - 🔗 链接内容获取:自动抓取消息中链接的网页内容,回复有依据;
- ⏰ AI 时间感知:AI 知道当前年-月-日、星期、时分秒,聊"现在几点"不再瞎编;
- 💬 主动发送消息:AI 可以主动发起聊天,并合并处理多条消息或表情包;
- 🖥️ 前端 WebUI:浏览器配置界面——启动程序、修改配置文件、生成和管理 Prompt,零代码操作;
- 🧠 记忆功能:AI 自动总结聊天记录,保存到 Prompt 或独立的核心记忆文件,长期人设不崩;
- 📅 定时任务:对话里直接说"15 分钟后提醒我出门"“每天早上八点叫我起床”,AI 设置定时提醒,支持语音通话提醒(原版支持,现在暂未实现);
- 🌐 联网搜索:需要实时信息时自动检索;
- 🎙️ 语音消息接收:接收语音消息(需在微信设置中开启"聊天中的语音消息自动转文字");
- 🔄 自动更新程序;
- 🎭 特色功能 - 角色论坛;
- ⚡ 指令功能:对话内指令控制机器人。
四、快速部署
环境要求:Windows 10/11 + 桌面版微信(4.1.12.26,不限版本)+ Python 3.8+ + 大模型 API Key。
一键启动
- 登录电脑微信,确保在后台运行;
- 双击 Run.exe(自动检测 Python/pip 环境并安装依赖,不检查微信版本);
- 浏览器自动打开配置页面,选择 API 服务商(DeepSeek / GPT / Gemini / 聚合网关如 WeAPIs)、模型,填入 API Key;
- 左侧「Prompt 管理」:参考自带模板编写或使用提示词生成器生成角色人设;
- 回到配置页,填入微信昵称或群聊名称,绑定对应 Prompt;
- 点击 Start Bot 启动,命令行显示启动成功即运行中;
- 自定义表情包:把
.gif/.png/.jpg/.jpeg放入emojis/对应情绪文件夹(可自建情绪种类)。
效果
给机器人发"你好",它会按人设回复(可能还带表情包);发张图片它能描述内容;说"提醒我 15 分钟后出门",到点它真的提醒你——拟人化的关键就是语气像人、记得住事、会接情绪、能干活。
五、提示词调优技巧(拟人化核心)
- 人物背景:越具体越好——年龄、性格、说话习惯、口头禅、和"你"的关系;
- 表达风格:明确"简短口语化"还是"温柔长篇",限制回复长度;
- 知识边界:告诉它知道什么、不知道什么,避免一本正经地胡编;
- 禁忌清单:不想聊的话题直接写进人设;
- 记忆利用:指示它"记住重要信息",让对话有连续性(配合记忆功能)。
六、常见问题
Q:启动报错"初始化微信接口失败/未找到已登录的客户端主窗口"?
A:先完全退出微信(托盘右键退出),重新登录后再启动;确认微信窗口可见(不能最小化到托盘)。
Q:支持哪个微信版本?
A:微信 4.1.12.26 已验证;本版本已去除版本检查,其它 4.x 版本也可直接启动(依赖 wechatauto-replica 的布局校准,小版本差异会自动适配)。
Q:可以在服务器上跑吗?
A:需要桌面版微信客户端 + 图形界面,建议本地 PC 或带桌面的 Windows 云主机挂机。
Q:如何更新?
A:程序支持自动更新;也可 git pull 手动更新。
七、合规声明
⚠️ 本项目仅供学习交流,请勿接入公众平台或用于任何生产/商业用途。微信对自动化操作有严格风控,强烈建议使用小号测试,因使用本项目导致的账号风险或法律责任由使用者自行承担。
项目基于 KouriChat(GPL-3.0)修改,延续开源协议;微信自动化底座为自研 wechatauto-replica(数据库解密 + 坐标 OCR,无逆向、无 Hook)。
相关阅读:wxauto 停更后,我复刻了一个支持微信 4.x 的自动化库:wechatauto
如果对你有帮助,欢迎 Star:https://github.com/fanyuantaier/wechatbot-new,https://github.com/fanyuantaier/wechatauto-replica
DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。
更多推荐



所有评论(0)