微信机器人新手教程30分钟用 wechat-bot 搭好微信AI自动回复与消息存档【免费下载链接】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 自动回复被的消息所有消息本地存档事后随时按关键词检索。用 wechat-bot 能得到什么一句话定位把扫码登录的微信接上大模型让它自动答话同时把消息全部落到本地。只在被时说话白名单你自己圈的允许触发回复的群和好友名单里的群消息、白名单好友的私聊才会触发回复机器人不会逢消息必答。消息不丢每条收到的文本都会追加写进本地 messages.jsonlJSONL 是一种一行一条 JSON 记录的纯文本格式事后可按关键词、群名、时间范围检索微信消息存档从此可回放。群聊统计一条命令谁最活跃、大家在聊什么、谁常年潜水一条本地命令直接出结果。动手前备齐这三样前提说明Node.js ≥ v18先执行node -v确认版本低于 v18 会运行报错建议升到 LTS 版国内网络 npm 镜像源依赖安装卡住时先切国内镜像源再重试能解决大部分安装问题建议用小号测试微信 web 协议存在风控微信对异常登录方式的检测与拦截先用测试账号跑通最稳妥三步上线1. 拉代码装依赖git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm install这条命令把项目拉到本地并装齐依赖。npm install中途卡住或失败时先切国内镜像源再重装。2. 配好白名单cp .env.example .env把示例配置复制成正式配置文件打开.env重点填三项BOT_NAME你的机器人昵称 ROOM_WHITELIST群名1,群名2 ALIAS_WHITELIST好友备注1,好友备注2⚠️BOT_NAME必须保留前缀ROOM_WHITELIST里的群名必须和真实群名一字不差——这两处是没反应的头号原因。最后给自动回复选一个大脑项目内置 deepseek、Ollama跑在本机的免费模型、Claude 等十余种服务填对应 API Key 即可。不想逐个平台处理计费的话也可以接第三方 API 聚合平台README 里列了两个示例服务商3. 一条命令扫码上线wb start --serve deepseek没执行过npm link的话用npm run start -- start --serve deepseek效果一样。--serve后面就是回复服务的名字deepseek、ollama、claude 等。终端打印二维码后用手机微信扫码机器人就上岗了去白名单群里它试一下。一条消息是怎么被处理的步骤做了什么源码位置收消息Wechaty 解析出发送人、群名、文本内容src/platforms/wechat/bot.js存档追加写入 .data/wechat/messages.jsonlsrc/platforms/wechat/messageStore.js触发判断白名单 被或私聊白名单才进入回复链路src/platforms/wechat/commandRouter.jsAI 回复请求--serve指定的模型服务把结果发回群里src/wechaty/sendMessage.js注意顺序存档先于回复判断。哪怕这条消息不满足触发条件、机器人不会回话它也已经落盘了——后面的微信关键词检索和群统计全靠这一步。上线后马上能做的两件事本地群统计不消耗任何 tokenwb analyze --room 群名 --stats-only输出消息总数、文本消息数、平均长度、高频发言成员等纯本地统计结果。想要模型结论把--stats-only换成--serve指定服务让它读最近的消息样本给出总结在群里直接发/统计 群 群名也能触发同样逻辑。在存档里做关键词检索wb wx searchanalyze 读的就是 messages.jsonl支持按关键词、群名、起止时间过滤这条命令则检索本机微信缓存的数据。写周报时把某个群近七天的记录捞出来就够了。新手高频问题 FAQ了机器人为什么没反应十有八九是白名单没对上BOT_NAME丢了或群名与真实名称有一字之差。从微信聊天界面顶栏复制真实群名原样替换再确认的是机器人账号本身。npm install 为什么中途失败常见原因是 puppeteer 的浏览器依赖拉不下来或 node 版本低于 v18。切国内镜像源重装必要时设PUPPETEER_SKIP_DOWNLOAD跳过浏览器下载再把 node 升到 LTS 版。微信弹出外挂警告怎么办默认免费 web 协议风控严格近期平台审查更严。只在测试账号上使用、白名单尽量小正式使用先读 README 里的协议切换说明别急着买长期协议。日志没报错但 AI 就是不回话多半是 API Key 没填、欠费或把两个相似的 key 填反了讯飞的配置键经常填反。先单独跑对应服务的测试脚本比如node src/deepseek/__test__.js验证通了再启动机器人。一条安全红线项目默认走微信免费 web 协议属于外挂式登录方式被平台检测到的概率不低——弹警告、限登甚至封号都有可能。请务必先用小号把整条链路跑通白名单保持最小化确定要正式使用时先阅读 README 中关于协议切换的说明再决定是否更换更稳的协议购买渠道也要谨慎别一次性买太久。下一步先跑一次--stats-only摸清自家群的数据再接上模型试试深度分析。想把 Pi 而不是模型 API 当大脑可以直接看 Pi IM 使用说明。打开终端把它 clone 下来今晚你的微信里就多一位不眠值班的同事。【免费下载链接】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），仅供参考
