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群里一天被 四十多次翻完消息就忘了对方在问什么。wechat-bot 是基于 WeChaty 的微信AI助手扫码登录后自动回复群聊私聊、盘点群数据、查本地聊天记录适合想用 AI 管群、又希望数据留在本机的人。 克隆到启动微信机器人搭建最短路径最短路径五步前两步照抄下面命令即可git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm i npm link cp .env.example .env克隆与安装按上面顺序执行npm link会把wb注册成本机命令不想 link 时后续wb可换成npm run start -- start --serve deepseek这类写法。复制配置最后一行把.env.example模板复制成.env之后只改这一个文件。填必填项只用填下表四项其余保持默认。启动终端执行wb start --serve deepseek。扫码终端出现二维码后用微信扫登录成功机器人开始收消息。必填项以 deepseek 为例字段含义填写示例BOT_NAME机器人账号的微信昵称要保留 可乐ALIAS_WHITELIST允许私聊触发的朋友备注逗号分隔张三,李四ROOM_WHITELIST允许自动回复的群名产品群DEEPSEEK_API_KEY云端模型的 API 密钥你的key选本地pi或ollama时不需要 API 密钥只填前三行。--serve参数可换成下一节的任意服务用 Pi 当 agent 时wb agent --im wechat --agent pi与wb start --serve pi等价。微信AI助手三个高频用法群自动回复、群数据盘点、本地记录查询群聊自动回复群聊要同时满足三件事才会回复群名在ROOM_WHITELIST里、消息 了机器人、内容是文本非文本消息不进回复链路。私聊只看发送者的备注或昵称是否在ALIAS_WHITELIST。不想每次被 都回可以加配AUTO_REPLY_PREFIX?只有以?开头的消息才触发适合用大号管理群。群数据盘点wb analyze读的是机器人本地捕获的消息记录默认最多取最近 5000 条。加--stats-only只做本地统计、不调用 AI想让模型总结话题和活跃成员再加--serve指定服务wb analyze --room 产品群 --stats-only wb analyze --room 产品群 --serve pi在群内直接发/统计 群 产品群也能出统计该命令只读本地记录且只对白名单里的联系人和群生效。本地记录查询不接模型只想查数据用wb wx系列。它通过 OpenCLI 的wx-cli读本机微信客户端缓存首次先执行wb wx init。常用wb wx sessions看最近会话、wb wx history查历史、wb wx search 关键词搜消息、wb wx sns-feed看朋友圈缓存。模型选型对照与微信AI助手推荐服务运行方式成本适合谁deepseek云端 API按量计费第一次搭、中文对话场景pi本地 agent免费想跑超出简单问答的任务ollama本地模型免费占本机资源隐私敏感的群ChatGPT云端 API付费网络要求高想用 GPT 生态拿不准就选deepseek只填一个 key服务列表稳定。--serve一共支持 12 个服务另含 doubao、Kimi、Xunfei、dify、tongyi、claude 等配置方式都是填 key、改参数。如果想通过第三方聚合 API 接 GPT 等模型可参考下面两张仓库内的平台宣传图避坑清单四个高频问题及处理二维码扫不上或登录即掉线现象终端出了二维码扫描报错或登录成功后很快被踢下线。原因项目默认走微信 Web 协议微信对它的审查严格容易触发风控Node 版本低于 18 也会导致启动异常。怎么办先确认 Node 版本不低于 18仍失败就删掉 lock 文件和 node_modules 重装依赖再换备用账号试。README 明确写了封号风险别一上来就用主号。发了消息不回现象私聊或群里 机器人都没有响应。原因回复触发要同时满足私聊发送者的备注或昵称在ALIAS_WHITELIST里群名在ROOM_WHITELIST里且消息 了BOT_NAME非文本消息不进链路。怎么办把三个字段逐字核对一遍。BOT_NAME必须保留群名要写群的全名白名单用逗号分隔。终端提示缺配置或请求超时现象启动后打印请先配置 .env 文件中的 XXX或请求一直超时。原因当前--serve服务对应的 key 没填或填到了错误的变量里例如讯飞有三个字段容易填反也可能是终端网络访问不到云端服务。怎么办对照.env.example找该服务需要的变量逐个补全需要代理就先给终端设置代理再重跑。用node ./cli.js --help可以先确认 CLI 本身可用。聊天内容会发到云端模型现象担心群聊内容被传出去。原因/分析和wb analyze --serve会把最近消息样本发给模型--stats-only和/统计只走本地统计不出机器。怎么办敏感群改用本地ollama或pi完全不想留记录把WECHAT_STORE_MESSAGES设为false。改动入口与启动后的下一步src/platforms/wechat/commandRouter.js/统计、/分析等群内命令的入口在这里加自定义命令。src/wechaty/sendMessage.js收到消息后的处理与回复逻辑触发条件和回复流程都在这里改。src/analysis/wechatAnalyzer.js本地统计与分析的实现想换统计维度就动这个文件。项目后续以接入更多 AI 服务为主没有固定时间表。你可以马上做的一步确认机器人在正常落消息WECHAT_STORE_MESSAGES默认true跑一次wb analyze --room 你的群名 --stats-only看本地统计数据符合预期后再用--serve接模型做深度分析。【免费下载链接】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），仅供参考