如果你维护着一个或多个 QQ 群，应该很熟悉这些重复工作：审核新人、发送欢迎语、回答常见问题、定时发通知、处理广告和刷屏、统计活跃度……事情单独看都不难，但每天重复做很消耗时间。
SmartQQ Assistant 是一款安装在 NapCat 上的 QQ 群智能运营插件。它把常见的群管理、内容治理、自动回复、活跃激励和数据记录集中到一个 Web 管理界面中，让机器人自动处理重复工作，管理员保留最终控制权。
项目官网：https://qbot.lerio.cn
官网提供最新版下载、产品介绍和安装帮助。
视频教程
我会同步录制一套安装与使用视频。视频发布后，可以在下面的哔哩哔哩系列中查看：
图文适合照着一步步操作，视频适合第一次安装时跟做，两者可以配合使用。
安装前需要准备什么
目前这篇教程以 Windows x64 + NapCat.Shell 为例。开始前准备：
- 一台可以持续运行的 Windows 电脑；
- 一个用于机器人的 QQ 账号；
- 最新版
NapCat.Shell.zip； - SmartQQ Assistant Windows 完整安装包。
建议使用专门的机器人 QQ，不要直接拿自己的主账号做高频自动化操作。机器人账号应先加入需要管理的群，并根据要使用的功能授予群管理员权限。
下载入口：
- NapCat：NapCatQQ 官方 Releases
- SmartQQ Assistant：官网最新版下载
- 安装帮助：官网安装指南
下载 NapCat 时请选择适用于 Windows 的 NapCat.Shell.zip。下载 SmartQQ Assistant 时请选择 Windows 完整安装包，其中包含中文安装器 install.bat。
一、安装并登录 NapCat
- 下载
NapCat.Shell.zip，把压缩包完整解压到一个固定目录。 - 启动 NapCat，按页面提示登录机器人的 QQ。
- 确认 QQ 已经正常在线，并且已经加入准备管理的群。
- 安装插件前，先完全退出 NapCat。
不要把 NapCat 放在临时目录，也不要直接在压缩软件中运行程序。以后插件的配置和本地数据都会跟随这套运行环境，固定目录更方便备份和维护。
二、安装 SmartQQ Assistant
- 从官网下载安装包，并把压缩包完整解压。
- 打开解压后的文件夹，双击根目录中的
install.bat。 - 根据中文提示选择刚才的 NapCat.Shell 根目录。
- 安装器会创建插件目录、备份旧版本，并处理 NapCat 插件白名单。
- 看到安装成功提示后，重新启动 NapCat。
如果电脑中有多套 NapCat，请仔细确认所选目录对应的是哪个 QQ。安装器只会修改你明确选择的 NapCat.Shell 目录。
安装失败时先检查请确认 NapCat 已完全退出、安装包已经解压、选择的是 NapCat.Shell 根目录。仍然失败时，查看安装包根目录中的中文安装日志；也可以参考包内的“安装说明.txt”进行手工安装。
三、打开 Web 管理界面
插件随 NapCat 启动后，在 NapCat 的插件页面找到 SmartQQ Assistant，打开插件配置中显示的 WebUI 地址。
第一次进入时按向导完成：
- 使用插件配置页显示的管理员初始密码登录；
- 阅读并确认使用说明；
- 修改管理员初始密码；
- 确认右上角显示的是正确的 QQ 实例，并检查在线状态；
- 进入“QQ群”，选择准备托管的群；
- 按需要开启并配置功能。
初始密码不会一直显示。修改后如果忘记密码，可以回到 NapCat 的插件配置页，通过“重置管理员密码”生成新的临时密码。
四、最推荐的首次配置顺序
第一次使用不需要一次打开所有功能。建议先完成一条最容易验证的工作流：
- 进入 QQ群，打开目标群的工作台；
- 先配置一条入群欢迎语；
- 再添加一条关键词回复，例如发送“帮助”时回复群规或常用链接；
- 根据群规则开启内容风控和刷屏检测；
- 用小号或测试成员在群里实际触发一次；
- 到数据管理/运行记录中确认机器人已经正确处理。
确认基础链路正常后，再逐步启用审核、签到积分、定时消息、转发和技能。这样出现问题时更容易定位是哪一项配置造成的。
SmartQQ Assistant 都有哪些功能？
下面按实际使用场景列出目前的主要功能。
1. 入群与新人管理
- 入群审核：按照问题答案、申请信息和规则辅助处理加群申请。
- 入群欢迎与静默：新人入群后自动发送欢迎内容，也可以配置新成员静默相关规则。
- 入群邮件：有新人加入时，把相关信息发送到指定邮箱。
- 本群黑名单：维护当前群的风险账号名单，减少重复审核和误放行。
- 全局黑名单：在多个托管群之间共用风险账号数据。
2. 自动回复与消息触达
- 关键词回复（FAQ）：为常见问题配置关键词和固定答案，自动回复群规、下载地址、活动说明等内容。
- 群公告：集中编辑和发布群公告。
- 定时发送：按指定日期、时间和周期自动发送群消息，适合通知、提醒和日报。
- 群消息转发：把符合条件的消息转发到其他群，减少多群重复操作。
- 私聊自动回复：针对机器人收到的私聊消息设置自动回复规则，并保留回复日志。
3. 群活跃与积分激励
- 每日签到：群成员通过关键词签到，并获得相应奖励。
- 积分账户：记录成员积分、变动原因和流水。
- 邀请奖励：根据邀请新人入群等行为发放积分。
- 发言奖励：按照发言行为和规则增加积分，支持限制频率，避免刷奖励。
- 互动游戏：通过技能扩展群内互动玩法。
4. 内容风控
- 内容审核：根据群规则识别并处理不合适的消息内容。
- 刷屏检测：发现短时间高频、重复发送等刷屏行为。
- 广告过滤：结合规则处理广告、推广和可疑内容。
- 全局违禁词库：统一维护多个群都要使用的违禁词规则。
- 风险记录：记录命中规则、处理动作和相关成员，方便管理员复查。
自动风控上线前，建议先用测试群或较宽松的规则观察命中情况，再逐步提高处理强度，避免正常讨论被误判。
5. 成员与批量操作
- 成员提取：查看和整理群成员信息，并支持导出。
- 名片批量更改：按统一规则批量整理群名片。
- 批量踢人：在确认名单后批量移除成员。
- 群备注与检索：群较多时，可以用备注和搜索快速找到目标群。
批量踢人、批量改名片等操作影响范围较大，执行前请认真检查目标群和预览名单。
6. 数据、统计与排查
- 数据管理：集中查看各类业务记录，并按条件检索。
- 群统计看板：查看群消息、活跃成员和功能运行情况。
- 运行记录：确认自动化任务是否实际执行成功。
- 全局系统日志：查看插件启动、连接、更新及系统操作等健康事件。
- 私聊回复日志：单独检查机器人的私聊自动回复情况。
- 数据导出：把需要留档或进一步分析的数据导出为 XLSX 表格。
遇到“配置了但没有生效”的问题，先确认 QQ 在线状态和机器人群权限，再到运行记录与系统日志查看原因，通常比反复修改配置更有效。
7. 技能中心
技能中心用于安装和启用额外能力，例如 AI 问答、天气查询、每日运势或群日报等。技能可以按需安装、配置和启停，不需要把所有扩展能力一次装完。
建议先把入群、风控、FAQ 等核心群管理流程配置稳定，再根据群成员的实际需求添加技能。
8. 系统管理与数据安全
- QQ 实例状态：确认当前管理的是哪个机器人 QQ，以及连接是否正常。
- 版本更新：检查插件新版本，并按提示完成更新。
- 安全与备份：备份插件配置和业务数据，便于迁移或恢复。
- 邮箱服务：为入群邮件等能力配置邮件发送服务。
- 管理员账号安全：修改或重置 WebUI 管理密码。
- 开放 API：使用独立令牌对接自己的自动化系统。
SmartQQ Assistant 的业务数据优先保存在本机。建议定期备份，并妥善保管管理员密码、开放 API 令牌和备份文件。
日常使用建议
- 每个群都单独检查配置，不要默认所有群使用同一套规则。
- 机器人需要执行禁言、踢人、修改群名片等操作时，要确保它拥有相应群权限。
- 新规则先小范围测试，再应用到活跃群。
- 定期查看运行记录和系统日志，及时发现 QQ 掉线、权限变化或规则误判。
- 使用批量操作前再次确认当前 QQ、目标群和成员名单。
- 定期从官网获取新版本，并在更新前做好备份。
常见问题
安装后找不到插件
先确认安装时选择的是当前正在运行的 NapCat.Shell 目录，然后完全退出并重新启动 NapCat。仍然没有出现时，查看安装日志和 NapCat 日志中是否有插件加载错误。
群列表为空
确认机器人 QQ 已正常登录、已加入目标群，并且 NapCat 显示在线。必要时重启 NapCat 后刷新 WebUI。
欢迎语或自动回复没有触发
检查当前群是否已托管、对应功能是否启用、规则条件是否匹配，并查看运行记录。涉及管理动作时，还要确认机器人拥有群管理员权限。
忘记 WebUI 管理密码
进入 NapCat 的 SmartQQ Assistant 插件配置页，使用“重置管理员密码”生成临时密码，登录后立即设置新密码。
相关入口
- SmartQQ Assistant 官网：https://qbot.lerio.cn
- 最新版下载：https://qbot.lerio.cn/download
- 帮助与安装指南：https://qbot.lerio.cn/guide
- NapCat 官方项目：https://github.com/NapNeko/NapCatQQ
- 哔哩哔哩教程系列：https://space.bilibili.com/523778047/lists
如果你只是想先体验，最简单的方式就是：安装 NapCat 和插件，选择一个测试群，先打开欢迎语和关键词回复。等确认机器人稳定在线，再逐步把审核、风控、积分和定时任务交给它。