15分钟配好微信AI自动回复：wechat-bot 新手上手指南-育师

15分钟配好微信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 是一个基于 Wechaty 的项目：手机扫码登录微信后，收到的消息交给 DeepSeek、ChatGPT、Kimi、Ollama 等 AI 服务处理并自动回发，还能做群统计和好友分析。

🧭 先搞懂它是什么：微信AI自动回复机器人怎么工作

wechat-bot 里的"机器人"本质上是一个你扫码登录的微信账号，通过 Wechaty 的 web 协议收发消息。整体链路是事件驱动：收到消息 → 校验白名单 → 交给 AI 服务 → 把生成的回复发回去。为了避免乱回，项目内建了白名单：私聊要求好友备注在名单里，群聊要求群名在名单里且消息里 @ 了机器人。同一条链路还能做群/好友的数据统计与 AI 分析，适合想搭微信自动回复、又需要社群运营统计的人。

🎯 先选场景，再动手：微信机器人适合哪些用法

wechat-bot 最常见的用法有 4 个，先挑一个你真正需要的场景再开始：

私聊自动回复：白名单内好友发消息，AI 直接应答，解决固定联系人来不及回的问题
群聊 @ 回复：白名单群里被 @ 机器人才回复，不逐条应答，避免刷屏
群/好友统计与分析：发/统计走本地统计（不调用 AI），发/分析让模型总结近期消息
本地数据查看：用wb wx系列命令读本机微信的聊天记录、群成员、朋友圈缓存

⏱️ 15分钟快速上手：微信自动回复安装步骤

整个过程就三步：克隆、改配置、扫码启动。开始前先核对 4 项前置条件：

Node.js：18.0 以上，建议 LTS 版本
微信账号：建议用小号，默认 web 协议存在警告和封号风险
AI 服务：准备一个云端模型 API key，或本地装好 Ollama
网络：用云端模型时，终端要能访问对应服务

操作步骤：

克隆项目、安装依赖、注册 wb 命令：

git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot && npm i npm link

装完后项目目录里应该出现node_modules，npm link结束后终端可以直接用wb命令。

复制配置模板：

cp .env.example .env

项目目录里应该出现新的.env文件，打开它，把BOT_NAME、ALIAS_WHITELIST、ROOM_WHITELIST三行改成自己的值。

启动微信自动回复服务：

wb agent --im wechat --agent pi

终端里应该出现微信登录二维码，用手机扫码完成登录。

如果不想注册命令，启动命令可换成npm run start -- start --serve pi。扫码成功后，让白名单好友发一条消息，收到回复即链路打通。

🔧 你一定会用到的配置：微信机器人 .env 参数说明

最常改的配置都在项目根目录的.env文件里，复制模板后改这几行就够：

BOT_NAME：填@机器人账号的微信昵称，群聊消息只有 @ 到这个名字才会触发回复
ALIAS_WHITELIST：逗号分隔的好友备注或昵称，只有名单内好友的私聊会被自动回复
ROOM_WHITELIST：逗号分隔的群名，名单外的群完全被忽略
AUTO_REPLY_PREFIX：填一个前缀后，只有文本匹配该前缀才回复，适合只想被特定口令触发的场景
--serve 服务名：回复用哪个模型在启动时指定，如wb start --serve deepseek；本地 Ollama 不用 API key，云端模型要配 key 和余额

想深入定制时，消息发送链路看 src/wechaty/sendMessage.js，微信内置/统计/分析命令的路由在 src/platforms/wechat/commandRouter.js，Pi 作为 agent 的参数详见 docs/pi-im-agent.md。

🛠️ 踩坑速查：微信自动回复常见问题解决

问题基本集中在白名单、协议风险、网络依赖三处，以下按现象、原因、解决三行给出：

现象：扫码登录后，发过去没回复原因：发信人不在白名单，或群聊里没有 @ 机器人解决：好友备注加进ALIAS_WHITELIST，群名加进ROOM_WHITELIST，确认群消息真的 @ 了BOT_NAME
现象：微信弹出外挂警告，账号有封号风险原因：默认免费的 web 协议容易被微信风控检测到解决：按 README 注意项换更稳定的 pad 协议，用小号，并缩小白名单范围
现象：npm i 报错，或 puppeteer 下载失败原因：Node 版本低于 18，或 Chromium 下载被网络拦截解决：升级到 Node 18 以上 LTS；puppeteer 仍失败就设置 PUPPETEER_SKIP_DOWNLOAD=true 再重装依赖
现象：配了云端模型（ChatGPT、DeepSeek 等）但不回复原因：API Key 没填、余额不足，或终端访问不了服务解决：核对.env里对应 key 与账户余额，给终端开代理后重试
现象：Pi Agent 回复很慢原因：PI_BIN 留空，每次用 npx 调起 pi 冷启动解决：本机全局安装 pi，配置PI_BIN='pi'后重启服务