Wxbot 是一个基于 Node.js、Nuxt.js 和 Wechaty 构建的个人微信号机器人平台,核心是为个人微信账号提供一个带 Web 管理后台的自动聊天与群管理工具。它通过 iPad 协议(wechaty-puppet-padlocal)登录微信,并在浏览器控制台中完成好友验证、关键词回复、群聊管理和定时任务等操作。
Wxbot 是什么?
Wxbot 是一个开源的个人微信号机器人平台,服务器端运行在 Node.js 上,SSR 前端使用 NuxtJS,UI 组件采用 Ant Design of Vue,数据持久化使用 MongoDB。它以微信账号为输入,经过后台规则处理后输出自动回复、群聊管理操作和定时消息推送,并提供一个可在浏览器访问的管理站点。该仓库发布在 GitHub,主题标签包含 nodejs、nuxt、wechaty,目前有 287 个 star。
核心特性
- 控制台 — 支持绑定机器人、登录、退出,并可在控制台设置自动通过好友验证的关键词,匹配后直接通过。
- 自动回复 — 针对好友、某个群聊或所有群聊设置关键词触发回复;机器人还能在加群邀请时回复群聊列表,让好友选择性进群。
- 踢人指令 — 机器人识别指令后自动把成员移出群聊,用于群内秩序管理。
- 好友管理 — “我的好友”页面可单独给某个好友发送消息。
- 群聊管理 — 可查看群聊列表、修改群名称、发布公告、发送群消息,并设置入群欢迎语、成员违规次数上限以及是否受机器人控制。
- 定时任务 — 针对好友、某个群聊或所有群聊设置定时任务,机器人在指定时间自动推送消息。
- 智能聊天 — 内置简单闲聊、成语接龙、查天气、查酒店、歇后语等功能,通过 config 中的 tianApiKey 调用天行 API 驱动。
谁适合使用 Wxbot?
- 个人开发者:想用 Wechaty 开发微信机器人,可用此项目作为带界面和后台的参考实现。
- 微信群管理员:需要自动通过好友验证、关键词回复、踢人和入群欢迎语来维护多个群聊。
- 运营人员:需要按时间给好友或群聊推送消息,使用定时任务功能即可。
- Nuxt.js 学习者:该项目展示了 NuxtJS + Vue + Ant Design of Vue + MongoDB 的完整前后端结构。
可以用 Wxbot 做什么?
- 社群运营者:设置入群欢迎语、违规次数上限和关键词回复,自动处理加群申请与重复违规成员。
- 客服场景:通过关键词自动回复常见问题,机器人持续响应好友和群聊消息。
- 营销推送:用定时任务在指定时间向所有群聊推送活动消息。
- 娱乐互动:启用成语接龙、歇后语、查天气和查酒店功能,为群聊增加互动。
如何运行 Wxbot?
准备条件:安装 Node.js v10 以上和 MongoDB,并推荐使用 cnpm 安装依赖。克隆仓库后执行 cnpm i 安装依赖,然后根据实际环境修改 config.js 中的 host、port、mongoUrl、secret 和 tianApiKey。开发模式运行 npm run dev 并访问 http://localhost:3000/,使用 admin/111111 登录;生产模式先 npm run build 再 npm start,可使用 PM2 管理进程。
优点与注意事项
- 优点:功能覆盖广,自带现代 Web 管理界面;代码结构包含前后端;支持单机插件版本,可把 bot 目录单独移出并修改 config.js 后执行
node index启动。 - 注意事项:README 和界面均为中文;默认管理员账号密码是 admin/111111,部署后应及时修改;依赖 MongoDB 和 wechaty-puppet-padlocal 协议。
常见问题
Wxbot 是免费的吗?
项目在 GitHub 上公开,README 未声明具体许可证,也未提及付费版本;任何人都可以下载、修改或部署。它使用 wechaty-puppet-padlocal 作为 iPad 协议,实际登录微信时需要相应的 PadLocal 服务。
如何登录管理后台?
启动开发或生产站点后,通过浏览器访问站点地址(开发模式为 http://localhost:3000/),输入默认用户名 admin 和密码 111111 即可进入控制台。
Wxbot 支持哪些群聊管理功能?
支持群聊列表管理、修改群名称、发布公告、发送群消息、设置入群欢迎语、成员违规次数上限,以及是否受机器人控制的开关;还可以通过指令将成员移出群聊。
可以定时发送消息吗?
可以。在“定时任务”页面中,你可以针对好友、某个群聊或所有群聊创建定时任务,机器人会在指定时间自动推送消息。







