从零到上线微信 AI 自动回复机器人 wechat-bot 新手实战指南【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot一个五百多人的工作群一天几千条消息同事在群里你问部署文档在哪你人已经在外跑业务根本看不到。wechat-bot 是一个基于 Wechaty 的微信 AI 自动回复机器人把微信扫码接到电脑AI 按白名单规则自动回复同时每条文本消息都落到本地文件随时可按关键词检索。先想清楚wechat-bot 适合解决什么一句话概括把微信账号变成一个只在你需要时才开口的应答者。工作群消息很吵但被时必须立刻有人应声历史消息不能丢想按关键词、群名、时间段翻查随时翻想知道群里谁最活跃、大家聊什么、哪些成员常年潜水不想手动刷记录。 如何搭建一个微信 AI 自动回复机器人环境准备确认 Node.js 版本并安装依赖前提是 Node.js v18 及以上LTS 更稳先确认版本再克隆仓库、装依赖node -v git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm installnpm install卡住时先切到国内 npm 镜像源再重试。如何配置白名单.env 里的三个关键字段执行cp .env.example .env得到正式配置重点填三项。BOT_NAME必须保留前缀ROOM_WHITELIST里的群名要和真实群名一字不差BOT_NAME你的机器人昵称 ROOM_WHITELIST群名1,群名2 ALIAS_WHITELIST好友备注1,好友备注2自动回复的大脑在项目内置的十余种模型服务里选一个deepseek、Ollama本地模型免费、Claude 等填上对应 API Key 即可。不想逐个平台处理计费也可以接第三方 API 聚合平台项目里列了两个示例服务商最快启动命令指定模型服务并扫码登录wb start --serve deepseek没执行过npm link的话npm run start -- start --serve deepseek效果一样。终端打印二维码后用微信扫一扫白名单群里的消息就会进入回复链路。上线之后只回消息、消息全量存档、群聊一键分析只在被时说话只有白名单群里的消息、白名单好友的私聊才触发回复再叠加前缀过滤机器人不会每条消息都接话。消息不丢每条收到的文本追加写进 .data/wechat/messages.jsonl事后可按关键词、群名、时间范围检索。群聊统计与 AI 总结谁最活跃、大家在聊什么、哪些人常年潜水本地统计直接出结果想深入再让接好的模型基于消息样本给结论。消息在代码里怎么走内部机制白话版整条链路四步读不读源码都该知道收消息Wechaty 解析出发送人、群名、文本见 src/platforms/wechat/bot.js。存档每条记录追加写进.data/wechat/messages.jsonl实现在 src/platforms/wechat/messageStore.js。这一步对不触发回复的消息同样执行后面的关键词检索和群统计全靠它。触发判断白名单 被或私聊白名单好友才进入回复链路见 src/platforms/wechat/commandRouter.js。AI 回复请求--serve指定的模型服务把结果发回群里见 src/wechaty/sendMessage.js。⚠️ 常见故障如何排查群里了没反应或者 AI 不回话。通常是两类问题白名单没对上BOT_NAME丢了或群名和真实名称有一字之差以及 API Key 没填、欠费、或把两个相似的 key 填反用讯飞的要特别留意。前一类从微信聊天界面顶栏复制真实群名原样替换再确认的是机器人账号本身后一类先单独跑对应服务的测试脚本比如node src/deepseek/__test__.js验证通了再启动机器人。npm install 中途失败。通常是 puppeteer 的浏览器依赖拉不下来或 node 版本低于 v18。设国内镜像源重装必要时设PUPPETEER_SKIP_DOWNLOAD跳过浏览器下载node 升到 LTS。微信弹出外挂警告。默认的免费 web 协议风控严格近期平台审查也更严。只在测试账号上使用白名单尽量小正式使用先读 README.md 里的协议切换说明别急着买长期协议。收尾先跑一次本地统计再接模型第一步建议先熟悉自家群的数据wb analyze --room 群名 --stats-only这一步是纯本地统计不消耗任何 token想要结论就换成--serve指定模型让它读最近的消息样本给出总结。在群里直接发/统计 群 群名能触发同样的逻辑。analyze 命令内部读取的就是messages.jsonl支持按关键词、群名、起止时间过滤wb wx search还能检索本机微信缓存的数据写周报时把某群近七天的记录捞出来就够用。若想把 Pi 而不是模型 API 当大脑项目里有单独的 Pi IM 使用说明。【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
