项目介绍

这是一个基于 Wechaty 和 Node.js 的微信 AI 机器人源码包，整理了中文小白安装脚本与使用教程。安装后可以通过微信私聊或群聊使用 AI 问答、生图、配音、音乐、视频解析、群聊总结、PDF OCR 等功能。

源码包不包含任何 API 密钥、微信登录状态、聊天记录或线上配置，安装者需要自行填写模型接口和白名单。发布版所有可安全标注的文件均加入了 www.lanlt.cn 二次发行标识，同时保留项目原始许可证和原作者信息。

主要功能

  • 微信私聊与群聊 AI 问答
  • 群聊必须真正艾特机器人，机器人会原生艾特发起人回复
  • Markdown 自动转换为适合微信阅读的结构化排版
  • AI 生图：1K、2K、4K
  • MiniMax AI 配音和音乐生成
  • 视频分享链接解析，主接口失败时自动切换备用接口
  • 今日、昨日和最近七天群聊总结
  • PDF 文本提取，扫描版自动使用中文 OCR
  • 按微信群独立开启或关闭生图、配音、音乐、视频解析和群聊总结
  • 管理员可一键关闭全部付费功能，减少接口消耗
  • 自有或已授权音频转为微信兼容 MP3，临时文件 24 小时后自动清理
  • 中文文件名保留、长回复智能分段

下载地址

源码安装包

点击下载微信 AI 机器人源码

小白安装教程

点击查看或下载小白安装教程

SHA-256 校验文件

点击下载 SHA-256 校验文件

源码包 SHA-256：

df50a7c1b4d18bfc1e7aa379076ccc595186215bcebdb2790a5946228e5e6af8

安装要求

  • Ubuntu 20.04、22.04 或 24.04
  • 建议至少 2 核 CPU、4 GB 内存
  • 可以登录网页版微信的微信账号
  • 至少一个可用的文字模型 API，默认示例使用 MiniMax

一键安装

上传压缩包到服务器后执行：

cd /opt
tar -xzf wechat-ai-bot-source-20260717.tar.gz
cd wechat-ai-bot
sudo bash install.sh

安装脚本会自动安装 Node.js、npm 依赖、FFmpeg、PDF 工具和中文 OCR。

配置机器人

编辑安全配置文件：

nano .env.hermes

至少填写以下内容：

BOT_NAME=home
ALIAS_WHITELIST=允许私聊机器人的微信昵称
ROOM_WHITELIST=允许使用机器人的群名
WECHAT_ADMIN_NAMES=管理员微信昵称
MINIMAX_API_KEY=你的API密钥
MINIMAX_MODEL=你的模型名称

多个昵称或群名使用英文逗号分隔。生图、配音、音乐和 Hermes 是可选功能，没有对应接口时可以留空或关闭。

扫码和后台运行

第一次先以前台方式运行，便于显示二维码：

./bot.sh run

扫码登录并测试成功后，按 Ctrl+C，再启动后台进程：

./bot.sh start

常用管理命令：

./bot.sh status
./bot.sh logs
./bot.sh restart
./bot.sh stop

微信命令示例

菜单
/生图 一只坐在窗边的橘猫
/生图2K 产品摄影，白色背景
/配音 欢迎使用微信机器人
/音乐 温暖流行｜今天阳光正好
/视频解析 <支持的视频分享链接>

群管理员可以真正艾特机器人后发送：

@home 功能状态
@home 开启生图
@home 关闭生图
@home 关闭音乐
@home 关闭视频解析
@home 关闭全部付费功能

安全说明

  • 安装包已经排除 .env、线上 .env.hermes、API 密钥、聊天记录、微信登录状态、运行日志、用户文件、历史备份和 node_modules。
  • .env.hermes 应保持 600 权限，不要提交到 GitHub 或发送到群聊。
  • 第三方视频平台会不定期修改页面，解析功能可能暂时不可用。
  • 媒体解析、下载和转码仅用于你拥有版权、已获授权或平台允许保存的内容。
  • 部分微信账号无法登录网页版微信，遇到此情况需要更换可正常登录网页版的账号。

完整操作和排错步骤请查看压缩包内的《小白安装教程.md》。