3分钟跑通WeChatBot_WXAUTO_SE:微信AI自动回复机器人零基础快速上手指南
【免费下载链接】WeChatBot_WXAUTO_SE【停止维护】LLM API 聚合对话工具。原项目仓库:https://github.com/KouriChat/KouriChat 本项目由iwyxdxl在原项目基础上修改创建。仅供学习,请遵守规定使用,请勿接入公众平台或者用于任何生产活动。项目地址: https://gitcode.com/gh_mirrors/we/WeChatBot_WXAUTO_SE
WeChatBot_WXAUTO_SE 是一个 LLM API 聚合对话工具,也就是能接入大模型 API、在微信里实现智能自动回复的 AI 机器人。本文是面向新手的完整指南:不需要命令行基础,3 分钟即可完成部署,让 AI 帮你自动回复微信消息。
一、项目能做什么?14 个核心功能一览
部署完成后,你的微信机器人将具备以下能力:
- 🤖智能自动回复:支持多用户/群聊同时聊天,可为每个人分配独立提示词(Prompt)
- 🖼️图片与表情包识别:能看懂对方发的图,还能根据情绪回复表情包
- 🌐联网搜索:获取消息中链接的网页内容
- ⏰定时任务:例如"15分钟后提醒我出门",支持语音通话提醒
- 💬记忆功能:AI 自动总结聊天记录,形成长期记忆
- ⏰时间感知:知道现在是几点、星期几,回复更自然
- 📢主动发消息、合并处理多条消息、角色论坛等特性
效果演示:机器人不仅能"聊",还能根据上下文生成符合角色设定的回复。
⚠️重要提醒:本项目仅供学习研究,请勿接入公众平台或用于任何生产活动。
二、快速安装:一键部署步骤
1. 环境准备(2 个前提条件)
| 条件 | 要求 | 说明 |
|---|---|---|
| 系统 | Windows | 通过 wxauto 控制电脑端微信 |
| 微信 | 3.9 版本电脑微信 | 登录并保持后台运行,Run.bat 会自动检查版本 |
| Python | 3.9 ~ 3.12 | 需勾选 "Add Python to PATH" |
2. 下载项目代码
git clone https://gitcode.com/gh_mirrors/we/WeChatBot_WXAUTO_SE3. 一键启动
双击运行根目录的 Run.bat,它会自动完成:
- ✅ 检查微信版本是否兼容(建议 3.9 版)
- ✅ 检查 Python 环境(3.9–3.12)
- ✅ 自动选择最快的 pip 镜像源(阿里源 → 清华源 → 官方源)
- ✅ 安装全部依赖(依赖清单见 requirements.txt,离线环境可使用 libs/ 下预置的 whl 包)
- ✅ 检查版本更新(由 updater.py 完成)
- ✅ 启动主程序,自动打开浏览器配置页面
依赖文件较多(flask、sqlalchemy、openai、lxml 等),首次运行耐心等待安装完成即可,全程无需手动执行 pip 命令。
三、WebUI 配置:最快完成 AI 接入
程序启动后会自动打开网页版配置编辑器(由 config_editor.py 提供服务),左侧菜单覆盖全部功能模块。新手只需做 4 步:
第 1 步:配置 Chat 模型
在左侧点击「Chat 模型配置」,选择你的 API 服务提供商(OpenAI 兼容接口均可),填入 API KEY 和模型名称。
第 2 步:创建 Prompt 提示词
进入「Prompt 管理」页面(参考 templates/character_forum.html 的角色风格),两种方式任选:
- 手写:参考 prompts/角色1.md、prompts/角色2.md 的自带样式编写
- AI 生成:在"提示词生成器"输入一句描述(如"为我生成xx角色的提示词"),点击"生成"即可自动产出完整角色设定
第 3 步:绑定微信用户
回到「用户列表」,填入你的微信昵称或群聊名称,在右侧下拉框选择刚创建的提示词,点击"添加用户"。这样每个用户/群聊就拥有了独立的 AI 人格。
第 4 步:启动机器人
点击页面右上角绿色的Start Bot按钮。此时保持电脑微信在后台登录状态,给对应用户发消息,AI 就会自动回复了 🎉
四、进阶小配置(可选)
🎭 自定义表情包
情绪识别功能会自动根据聊天情绪回复表情包。想换成自己的表情包?把.gif / .png / .jpg / .jpeg文件放入 emojis/ 下对应的情绪文件夹即可,现有情绪分类包括:
emojis/happy/开心emojis/loved/喜爱emojis/sad/难过emojis/angry/生气emojis/surprised/惊讶- 也可自行新建文件夹添加新的情绪种类
🛠️ 常用辅助文件
| 文件 | 用途 |
|---|---|
| 一键检测.bat | 环境一键体检,排查启动失败原因 |
| config.py | 核心配置文件,WebUI 的修改都会落盘到此 |
| recurring_reminders.json | 定时提醒任务的持久化存储 |
| CHANGELOG.md | 版本更新记录(当前 v3.25.1) |
| DEPENDENCIES.txt | 依赖库许可证说明 |
五、新手常见问题 FAQ
Q1:双击 Run.bat 后提示微信版本不对?下载并安装微信 3.9 电脑版(4.x 暂不支持),程序会自动重新检测。
Q2:机器人不回复消息?依次检查:① 电脑微信是否登录且后台运行;② 用户列表中的昵称/群名是否与实际完全一致;③ API KEY 是否有效;④ 点击右上角"程序运行日志"查看报错。
Q3:收到语音消息不响应?需在微信设置中开启"聊天中的语音消息自动转文字"功能。
Q4:密码、安全设置在哪?WebUI 内置密码登录机制(templates/login.html、templates/password_setup.html),首次访问按提示设置即可,配置导入导出也可在页面上完成。
至此,你的微信 AI 自动回复机器人已经跑通。后续想深入了解消息处理逻辑,可以阅读主程序入口 bot.py;项目遵循 GNU GPL-3.0 许可证,更多声明见 LICENSE 与 LICENSE_COMPLIANCE.md。再次提醒:本项目已停止维护,仅供学习交流使用。
【免费下载链接】WeChatBot_WXAUTO_SE【停止维护】LLM API 聚合对话工具。原项目仓库:https://github.com/KouriChat/KouriChat 本项目由iwyxdxl在原项目基础上修改创建。仅供学习,请遵守规定使用,请勿接入公众平台或者用于任何生产活动。项目地址: https://gitcode.com/gh_mirrors/we/WeChatBot_WXAUTO_SE
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考