微信机器人完整指南让 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 把微信扫码后的私聊、群聊消息交给 DeepSeek、Kimi、Ollama 等 AI 服务处理实现自动回复还能统计群聊、分析好友。这篇微信机器人配置教程会带你走完环境准备、AI 接入、功能验证到长期部署的全过程。开始前的三个前置条件三件事确认好后面基本不会卡住前置条件检查方式不满足时怎么办Node.js ≥ 18LTS 优先终端执行node --version官网下载安装 18 以上的 LTS 版本能正常访问 npm 源npm config get registry看当前源切换到国内镜像源命令见下一节一个可用的 AI 服务 API Key登录所选服务商后台确认密钥状态正常注册对应平台申请 Key多数服务有免费额度拉取代码、安装依赖并完成首次启动环境检查和依赖安装是一条主线按顺序执行即可git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot npm config set registry https://registry.npmmirror.com npm inpm i结束后项目根目录会多出 node_modules 文件夹终端没有红色报错就算通过。依赖里包含 puppeteer会顺带下载浏览器内核第一次安装偏慢如果卡在这一步设置环境变量PUPPETEER_SKIP_DOWNLOADtrue后重新安装。启动入口是 cli.js消息处理主逻辑在 src/index.js之后排查问题会常看这两个文件。再复制一份配置文件模板cp .env.example .env.env是机器人唯一需要改的配置文件API Key 和白名单都在里面下一节统一填。首次启动命令放在这里终端执行后会出现登录二维码用手机微信扫码即可npm run start -- --serve deepseek注意微信 Web 协议存在风控提示甚至封号的可能建议先用备用号体验并严格控制白名单范围。如果终端提示请先配置 .env 文件中的 xx说明还缺下一节要填的配置项补全后重新执行这条命令就行。AI 服务怎么选 项目内置 12 种服务见 src/index.js 里的 serveList挑一个填.env就能跑。先对比最常见的四个服务特点适用场景需配置项DeepSeek国内直连中文理解好有免费额度国内网络、个人日常问答DEEPSEEK_API_KEYKimi长文本处理能力突出总结长对话、长文档问答KIMI_API_KEYOllama本地运行数据不出机器隐私敏感、离线环境OLLAMA_URL、OLLAMA_MODELChatGPT模型能力上限高需付费且走代理对回答质量要求高OPENAI_API_KEY不确定就先选 DeepSeek只配一个 Key网络也没有门槛。.env最小可用配置如下以 DeepSeek 为例BOT_NAME你的微信昵称 ALIAS_WHITELIST好友备注1,好友昵称2 ROOM_WHITELIST技术交流群,工作群 DEEPSEEK_API_KEY你的密钥白名单几个项的含义BOT_NAME加机器人微信昵称群聊里只有它才触发回复ALIAS_WHITELIST允许私聊触发的好友备注或昵称英文逗号分隔ROOM_WHITELIST允许接入的群名同样逗号分隔非文本消息不会进入回复链路只有文本才触发想省掉逐个申请 Key 的麻烦也可以用聚合类 API 平台一次接入多家模型三种方式确认微信机器人在工作确认.env填好后重新执行启动命令扫码登录成功再按下面三条逐一验证私聊回复让白名单好友发一句介绍一下你自己。判断标准几秒内收到 AI 生成的答复且内容与问题对得上。群聊触发在白名单群里机器人并提一个问题。判断标准被时回复、不被时沉默说明白名单过滤生效。连接测试每个 AI 服务目录都带__test__.js脚本启动前先跑一遍。判断标准打印出模型回答且不抛错说明 Key 和网络都通了。node ./src/deepseek/__test__.js选 Kimi 的话直接npm run test:kimi即可。遇到问题先查这张表 现象可能原因解决办法安装依赖卡住或报网络错误npm 源不通、puppeteer 下载慢确认已切国内镜像源下载失败时设置PUPPETEER_SKIP_DOWNLOADtrue重装扫码登录后没有任何回复白名单没配或备注写错核对ALIAS_WHITELIST、ROOM_WHITELIST名称要和微信里显示的完全一致启动提示请先配置 .env 文件中的 xx对应服务的 Key 没填按提示的变量名补全.env后重新启动调用 AI 报鉴权/额度错误Key 填错或额度用完回服务商后台核对 Key 和余额境外服务一直超时终端没走代理为终端配置 http/https 代理环境变量后重试微信弹出外挂警告免费版 web 协议触发风控换备用号、减少频繁登录登出README 中有专门的风险说明微信机器人部署与长期稳定运行Docker 部署用仓库自带的 Dockerfile 构建镜像配置通过挂载注入。好处是环境被镜像固定服务器上不用单独装 Nodedocker build -t wechat-bot . docker run -d --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot构建时如果 node 基础镜像下载反复超时先把 node 镜像拉成本地镜像再改 Dockerfile 指向它。进程管理裸跑node cli.js挂了就没法自动拉起建议用 pm2 托管pm2 start cli.js进程异常退出会自动重启还能随时看日志。日志轮转消息会持续追加到.data/wechat/messages.jsonl日志长期增长会占满磁盘。开启 pm2 自带的日志切割或为日志目录配置 logrotate 定期压缩归档。配置备份.env和.data/wechat目录定期打包备份。前者丢了配置全无后者是全部聊天历史换机器时直接恢复就能接着用。熟悉之后可以改 src/wechaty/sendMessage.js 实现消息自动转发或在 src/platforms/wechat/commandRouter.js 里加定时任务、群管理指令项目还内置了/统计/分析命令和 Pi agent 接入说明值得继续往下挖。【免费下载链接】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），仅供参考