微信AI助手：30分钟从扫码到自动回复的最短上手指南-迪斯科星球

微信AI助手：30分钟从扫码到自动回复的最短上手指南

【免费下载链接】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 这个微信AI助手把扫码登录后的消息交给 AI 处理：DeepSeek、Kimi、ChatGPT、Ollama、Pi 等 12 个模型随便挑，自动回复、群聊分析、聊天记录本地管理一次到位，MIT 协议完全开源。照着往下做，你拿到的是一个能扫码上线的机器人。

🧠 它到底能干嘛

基于 WeChaty 的 IM 机器人：微信扫码登录后，消息自动丢给 12 种 AI 服务之一回复；群聊和好友可以做活跃度统计加 AI 深度分析；聊天、联系人、朋友圈缓存全部存在本地。不碰云端，数据自己攥手里。读完这篇，你的终端里就会挂着一个二维码。

🚀 从零到跑通：最短路径

先 clone 仓库：

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

然后装依赖并把 wb 命令注册到系统：

npm i npm link

看到终端没有报错、wb --version能打出版本号就对了。

接着复制出 .env 并填关键项：

cp .env.example .env

必填只有四个：机器人昵称、私聊白名单、群白名单、本地数据目录：

BOT_NAME='@你的微信昵称' ALIAS_WHITELIST='好友备注1,好友昵称2' ROOM_WHITELIST='群名1,群名2' WECHAT_STORE_MESSAGES='true'

用云端模型就再补一个 API Key，比如DEEPSEEK_API_KEY。

最后启动，用本地 Pi 当大脑：

wb agent --im wechat --agent pi

终端打出二维码、控制台出现 service type 那一行就对了；不想全局命令的话，所有wb ...都能换成npm run start -- ...。

🎯 功能逐个看

12 个模型自动回复

--serve后面跟服务名即可切换，本地 Pi 零成本，云端 deepseek、ChatGPT、claude 按需付费：

wb start --serve deepseek

每个模型一个独立文件夹，想换脑就换目录，逻辑不用重写。

群聊与好友分析

先跑纯本地统计，一条消息都不外传：

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

加上--serve pi就调 AI 做话题归纳。统计口径在 src/analysis/wechatAnalyzer.js 里，想加指标直接改这里。

本地数据管理

wb wx sessions看最近会话，wb wx history翻聊天记录，wb wx sns-feed翻朋友圈缓存。消息落盘在.data/wechat/messages.jsonl，备份就是拷一个文件的事。

飞书也接了

wb lark login授权后，wb lark messages --chat-id oc_xxx读消息、wb lark send发消息。飞书目前是 CLI 通道，还没有实时事件自动回复，README 里写得明明白白。

🔍 跟它过一遍真实场景

痛点：群运营想知道这个月谁最活跃、话题往哪走，翻聊天记录翻到眼花。

你敲：

wb analyze --room "技术交流群" --stats-only

结果：终端直接吐出一份 JSON——消息数、文本消息数、平均长度、发言排行榜一次列清，不花一分钱 API 费。想进一步让 AI 总结话题，把命令里的--stats-only换成--serve pi就行。

⚠️ 新手最容易卡的 4 个地方

扫码失败：多半是网络或微信风控。换稳定网络再试；仍被拒就别硬扫，默认 web 协议有封号风险，README 专门提醒过，换更稳的协议再说。

AI 不回消息：9 成的原因是 .env 没填全。BOT_NAME带不带 @、白名单写的是不是好友备注、当前--serve对应 Key 对不对，三项对着控制台错误信息查一遍。

白名单没生效：群聊要同时满足两条——群名在ROOM_WHITELIST、消息里 @ 了BOT_NAME，少一条都不触发；私聊则看ALIAS_WHITELIST里的好友备注或昵称是否和微信里完全一致。

Node 版本报错：低于 18 直接跑不起来，升级 Node 到 LTS 再重装依赖。

📚 想再深入一点

消息怎么被触发的，看 src/wechaty/sendMessage.js，白名单匹配和回复链路都在这里。
微信内置/统计、/分析命令的解析逻辑，在 src/platforms/wechat/commandRouter.js，加自定义命令也改这里。
把 Pi 当正式 agent 跑，细节在 docs/pi-im-agent.md，含完整配置样例。

另外本地跑npm run test:analysis可以验证分析模块，不依赖微信登录，改完代码顺手测一下。

wechat-bot 把微信消息变成可自动回复、可统计的数据，MIT 协议，改源码不受限制。clone 下来，把 .env 填好，半小时后你的终端里就会挂着第一个二维码。

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

企业官网建设流程全解析