三步跑通微信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 把微信扫码后的消息交给大模型自动回复每条文本落盘存档支持群聊统计和关键词检索。先跑起来wechat-bot 三步配置教程环境准备检查 node 并安装依赖先确认 Node.js 版本项目要求 v18.0 以上低了会直接运行报错node -v git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm i成功信号node -v输出 v18 或更高npm i跑完没有红色报错。卡住的话切国内镜像源再重装npm config set registry https://registry.npmmirror.com最小配置.env 只填 5 项cp .env.example .env.env里填必填的 5 项以 deepseek 为例本地 Ollama 则改填OLLAMA_URL、OLLAMA_MODELBOT_NAME你的微信昵称 ROOM_WHITELIST群名1,群名2 ALIAS_WHITELIST好友备注1,好友备注2 WECHAT_STORE_MESSAGEStrue DEEPSEEK_API_KEY你的key最容易填错的两处多数人卡在这一步BOT_NAME必须保留前缀丢了机器人永远收不到群触发ROOM_WHITELIST群名必须和真实群名一字不差从微信聊天顶栏原样复制。--serve支持 deepseek、ollama、ChatGPT、claude、pi 等 12 种服务除本地 Ollama 外都需在.env填对应 API key。首次验证扫码启动与触发测试npm link wb start --serve deepseeknpm link把wb注册成本机命令没跑这步的话用npm run start -- start --serve deepseek效果一样。启动后终端打印二维码手机微信扫码。成功信号日志出现has logged in和Automatic robot chat mode has been activated。再在白名单群机器人发一句话群里出现 AI 回复、.data/wechat/messages.jsonl新增一行链路就跑通了。谁能拿它干什么4 个高频场景群聊值班只在被时开口。机器人只响应白名单群和白名单好友私聊不插话刷群。验证群里它问部署文档在哪群里应出现回复。群聊体检一条命令出报告。wb analyze --room 群名 --stats-only纯本地统计不耗任何 token。验证跑完看到消息总数、文本消息数、平均长度、高频发言排行想要结论就加--serve deepseek让模型读最近消息样本做总结。写周报前先捞存档。没触发回复的消息也写进了messages.jsonl。验证wb analyze --room 群名 --query 部署 --stats-only按关键词过滤统计看谁提过什么不用翻聊天窗口。大脑一个参数换。--serve在 deepseek、ollama、ChatGPT、claude、Kimi、pi 等服务间切换。验证换成wb start --serve ollama再发消息回复由本地模型生成。它是怎么运转的一条消息的 4 段旅程一条群消息进来走 4 步收消息Wechaty 扫码登录解析出发送人、群名、文本内容先存档每条文本追加写入.data/wechat/messages.jsonl。不触发回复也落盘检索和群统计全靠它判触发私聊要求发送人在ALIAS_WHITELIST群聊要求群名在ROOM_WHITELIST且消息含BOT_NAME/统计 群 群名这类以/开头的命令也在这里路由AI 回话按--serve分发到对应 provider拿到回复发回微信环节职责对应源码文件收消息扫码登录、解析消息内容src/platforms/wechat/bot.js存档追加写本地messages.jsonlsrc/platforms/wechat/messageStore.js触发判断白名单 校验、/统计命令路由src/platforms/wechat/commandRouter.jsAI 回复按--serve分发到模型服务并发回src/wechaty/sendMessage.js、src/wechaty/serve.js出问题怎么办4 个高频坑现象群里了机器人没反应。原因白名单没对上——BOT_NAME丢了或群名差一个字。解法从微信顶栏复制真实群名原样替换确认的是机器人账号本身。现象日志没报错但 AI 不回话。原因API key 没填、欠费或两个相似的 key 填反了讯飞用户最常栽在这。解法先单独跑对应测试脚本比如node src/doubao/__test__.js验证通了再启动。现象npm i中途失败。原因puppeteer 拉不下浏览器或 node 低于 v18。解法切国内镜像重装puppeteer 卡住就设PUPPETEER_SKIP_DOWNLOADtrue跳过node 升级到 LTS。现象微信弹外挂警告。原因默认免费 web 协议风控严格。解法只在测试账号上用、白名单尽量小正式使用先读 README.md 里的协议切换说明别急着买长期协议。收尾下一步做什么先跑一条wb analyze --room 你的群名 --stats-only熟悉自家群的数据再接模型做深度分析。想把 Pi 当大脑而不是模型 API按 Pi Agent IM 使用说明 配置即可切换。如果你不能接受账号被外挂警告甚至封号的风险又不需要 7×24 值班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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考