微信接入AI自动回复：wechat-bot 消息存档与检索上手指南-酒店常州论坛

微信接入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

你所在的那个 300 人群，一天平均 800 条消息，同事 @ 你问"部署文档在哪"，三分钟后就被刷走。wechat-bot 干的就是这件事：微信扫码接进电脑，AI 接手自动回复，每条文本本地存档，之后随时按关键词检索。这篇教程带你从 clone 到机器人上岗。

上线之后你能得到什么

按场景一条条说：

场景	行为
白名单群里有 @	触发 AI 回复
白名单好友私聊	触发 AI 回复
其余文本消息	只存档，不回复
存档数据	按关键词、群名、时间范围检索
群聊统计	谁最活跃、谁常年潜水，本地出结果

关键在"只存档不回复"这一行：不管消息触不触发回复，都会写进.data/wechat/messages.jsonl。后面的关键词检索和群统计全靠这个文件，它是整个项目里最值钱的东西。

从 clone 到扫码登录

环境和依赖

Node.js 需要 v18 及以上，建议直接上 LTS：

git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm install

npm install卡住时，切国内 npm 镜像源再重试，大部分安装问题都能解决。

.env 白名单怎么配

cp .env.example .env

核心是三项：

BOT_NAME='@你的机器人昵称' ROOM_WHITELIST='群名1,群名2' ALIAS_WHITELIST='好友备注1,好友备注2'

BOT_NAME必须保留@前缀；群名和真实群名一字不差，这是后面排查问题的第一嫌疑点。

再挑一个"大脑"：--serve支持 deepseek、ChatGPT、Claude、Kimi、Ollama（本地模型，免费）、pi 等十余种服务，填对应 API Key 即可。不想逐个平台申请，也可以接第三方 API 聚合平台：

启动并扫码

wb start --serve deepseek

没跑过npm link的话，用npm run start -- start --serve deepseek效果一样。终端打印二维码，手机扫一下，机器人就上岗了。

一条消息的完整处理路径

一条文本从进群到被回复，走四个环节：

接收：Wechaty 解析出发送人、群名、文本内容。
存档：追加写入.data/wechat/messages.jsonl，与是否回复无关。
判断：查白名单、查是否被 @、查前缀（如果配了），逻辑在 src/platforms/wechat/commandRouter.js。
回复：请求--serve指定的模型服务，把结果发回群里，实现在 src/wechaty/sendMessage.js。

第 3 步就是"不逢消息必答"的设计来源：白名单群的 @、白名单好友的私聊才进回复链路；再配上AUTO_REPLY_PREFIX，消息还得带指定前缀。

本地存档怎么用

关键词检索

analyze 命令内部读的就是 messages.jsonl，支持按关键词、群名、起止时间过滤；wb wx search还能直接检索本机微信缓存的数据：

wb wx init wb wx search

写周报时，把某个群近七天的记录捞出来贴上去就够了。

群统计：先本地，再让模型下结论

纯本地统计，不消耗任何 token：

wb analyze --room "群名" --stats-only

想要结论，换成模型分析：

wb analyze --room "群名" --serve ollama

在白名单群里直接发/统计群群名也能触发同样的逻辑。

启动后没反应怎么办

@ 了机器人却石沉大海时，按顺序过四个检查点：

查 @ 对象：@ 的是机器人账号本身，且BOT_NAME带着@前缀。
查群名：从微信聊天界面顶栏原样复制替换配置，别凭记忆手打。
查 Key：单独跑一次对应服务的测试脚本，比如node src/deepseek/__test__.js，通了再启动机器人；漏填、填反两个相似的 key 是最常见的坑。
查协议风控：微信弹出外挂警告时，说明默认免费 web 协议被风控盯上了。只在测试账号上跑、白名单尽量小；要正式用，先读 README 里的协议切换说明，别急着买长期协议。

如果想让 Pi 而不是模型 API 当大脑，项目里有单独的流程说明：docs/pi-im-agent.md。

现在就挑一个不忙的群，跑一次wb analyze --room "群名" --stats-only——先摸清自家群的数据底细，再决定接哪个模型。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析