企业官网建设流程全解析

wechat-bot：4步搞定微信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

还在被微信消息刷屏吗？一边回工作群、一边答私聊问题，一天下来手都打酸了。wechat-bot 是一个基于 Wechaty 的微信自动回复机器人：扫码登录微信后，AI 替你接管消息，自动回复群聊和私聊，还能顺手做群聊统计和好友分析，让你从重复劳动里解放出来。

🚀 快速上手：4步搞定

第1步：准备环境确认已安装 Node.js（要求 v18.0 以上，建议用 LTS 版本），版本过低会直接运行报错。

第2步：获取项目代码

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

第3步：安装依赖并注册命令

npm i npm link

装完后wb就成了本机命令，后面所有操作都靠它；不想 link 的话，把wb xxx换成npm run start -- xxx也一样。

第4步：配置并启动

cp .env.example .env wb agent --im wechat --agent pi

在.env里至少填三样：BOT_NAME（形如@你的微信昵称）、ALIAS_WHITELIST（允许私聊自动回复的好友备注）、ROOM_WHITELIST（允许接入的群名）。启动后终端会弹出二维码，微信扫码登录，完成配置后即可开始使用。

🧠 核心能力拆解

1分钟接入新AI模型

回复"大脑"完全可切换，启动时加一个--serve参数就行：

wb start --serve deepseek wb start --serve ChatGPT wb start --serve ollama

当前可选的服务有十几个：deepseek、ChatGPT、Kimi、Xunfei（讯飞）、doubao（豆包）、tongyi（通义）、ollama、claude、dify、302AI、pi等。每个服务都是独立模块，互不干扰，比如 src/deepseek/、src/xunfei/，想换大脑就换个参数。讯飞每个模型有 200 万免费 token，豆包支持图片输入和深度思考，Ollama 则可以直接跑本地模型、数据不出机器。

怎么控制自动回复范围

这是它不"社死"的关键。默认规则很克制：

• 私聊：只有ALIAS_WHITELIST里的好友发消息才会回复
• 群聊：群名在ROOM_WHITELIST里、且消息里@BOT_NAME才触发
• 非文本消息（图片、语音等）不会进入回复链路

白名单配多配少，完全由你决定，避免机器人逢人就答。

一键分析群聊和好友数据

登录后的消息会落到本地 JSONL 文件，随时可以统计和深挖：

wb analyze --room "群名" --stats-only wb analyze --friend "好友备注" --stats-only

加--stats-only只做本地统计、不调 AI；去掉后接--serve则让模型做深度分析。甚至可以在微信聊天里直接发/统计 群 XX群或/分析 好友 备注，不用切到终端。

🛠️ 进阶定制

前缀开关AUTO_REPLY_PREFIX用大号的人最需要的配置。填一个前缀后，只有消息匹配该前缀才触发回复（群聊会先去掉@BOT_NAME再匹配）。效果：平时该账号正常聊天，想调机器人时打个暗号才启动，互不干扰。

业务逻辑改哪里白名单解决"回不回"，想改"怎么回"就看两个文件：消息收发主链路在 src/wechaty/sendMessage.js，群内命令路由在 src/platforms/wechat/commandRouter.js。想加自定义指令、过滤逻辑，从这里切入即可。

📌 典型使用场景

上班族：工作助手把客户群和常用同事加进白名单，群里被 @ 时 AI 先接住常见问题，你只处理真正重要的对话，下班时间不再被消息绑架。

学生党：学习伙伴学习群、答疑群配进ROOM_WHITELIST，遇到重复问题让机器人先答，还可以用/分析定期总结群里的讨论重点。

群主：社群管家用wb wx members、wb analyze --stats-only定期看群活跃度和成员情况，配合自动回复欢迎新成员，管理负担明显变轻。

⚠️ 避坑速查

• 封号风险：默认免费 Web 协议会被微信风控盯上，README 明确提示有警告/封号可能。只用在你能接受的账号上，别频繁登录登出，重要账号建议换更稳定的协议。
• 依赖装不上：国内网络推荐换 npm 镜像源再装；puppeteer 卡住时设置PUPPETEER_SKIP_DOWNLOAD='true'再试。
• 消息不回复：九成是配置问题——BOT_NAME要带@、好友备注/群名要和微信里显示的一致、群聊消息确实@了机器人。
• 云端模型不通：检查 API Key、余额和模型名是否正确，终端网络是否需要开代理。
• 验证方法：先跑node ./cli.js --help确认 CLI 正常，再跑npm run test:analysis验证分析模块，最后再扫码上线。

让重复的回复交给机器人，你把时间留给真正重要的对话。扫码试一下 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