Back to templates

Template details

Wxbot

微信机器人,个人微信号小助手平台,基于 Node.js、Nuxt.js 和 Wechaty,提供 Web 管理后台、自动回复、群管理和定时任务。

About this template

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 支持哪些群聊管理功能?

支持群聊列表管理、修改群名称、发布公告、发送群消息、设置入群欢迎语、成员违规次数上限,以及是否受机器人控制的开关;还可以通过指令将成员移出群聊。

可以定时发送消息吗?

可以。在“定时任务”页面中,你可以针对好友、某个群聊或所有群聊创建定时任务,机器人会在指定时间自动推送消息。