NapCatQQ 群组管理：4 个真实场景下怎么用 OneBot 接口跑起来

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ

NapCatQQ 是基于 NTQQ 的 Bot 协议端框架，群组管理走 OneBot 11 接口，代码集中在 群组接口目录。你面对的问题通常是：加群申请几十条没人点、有人刷屏没人力处置、公告和文件还靠手工转发。下面按 4 个场景说明具体怎么调。

1️⃣ 自动处理入群申请和邀请

群成员超过 200 之后，申请和邀请经常一天堆几十条，漏审一周就成常态。对应接口是 set_group_add_request：传flag和approve，传reason可以带一条拒绝理由；它按seq先查邀请通知再查加群通知，找不到会直接报错，不会误操作。入口在 WebUI 左侧菜单接口调试（路由/debug/http）：所有接口 schema 是运行时拉取的，找到该接口填入参数发送即可，也可以从自己的机器人代码里走 HTTP 调用。结果可验证：请求处理掉后，QQ 客户端里对应条目消失，被拒绝的人会收到你写的理由。

2️⃣ 批量调整权限、禁言和踢人

有人持续刷屏，你希望一次处理一批，而不是挨个点。三个接口分工明确：set_group_admin 把成员设为或取消管理员；set_group_ban 按秒数禁言，duration传 0 表示取消；set_group_kick 移除成员。权限检查内置在实现里：非群主身份不能禁言管理员，群主才能禁言管理员，错误会原样抛回，不会静默失败。配合get_group_shut_list接口可以核对当前被禁言的人还剩多少时间，方便做批量放行。

3️⃣ 群公告、群文件和精华消息统一发出去

规则变更要全员确认、每周的素材包要丢进群文件，这两件事过去都是手工。公告走 send_group_notice：内容、图片、置顶、是否强制确认都能传，公告失败会给出具体错误而不是"已发送"假象；群文件走 upload_group_file：支持本地路径或 URL，folder指定目录，返回file_id可直接用于get_group_file_url生成下载链接；值得保留的内容调set_essence_msg设为精华，配合get_group_essence随时查列表。一次公告加一次上传，群里就同时有了通知和文件，不再需要转发截图。

// 机器人代码里禁言 30 分钟，HTTP 方式调用 const r = await fetch('http://127.0.0.1:3000/set_group_ban', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` }, body: JSON.stringify({ group_id: '123456789', user_id: '23456789', duration: 1800 }), });

4️⃣ 拉取成员名单做日常监控

每周想知道谁进了群、谁是管理员、谁没改名片，手动翻名单不现实。get_group_member_list 一次拉全部成员，返回 QQ 号、群名片、职位、入群时间；no_cache传true强制走实时数据。再配get_group_info拿群规模、get_group_detail_info拿群主、管理员列表和待审核申请数量，就能搭一份每周数据对比：成员净增、新晋管理员、长期未发言的成员名单都能算出来。

常见问题

• 接口调用报权限错误？检查机器人自身的群身份，非群主不能禁言管理员、不能踢群主，错误信息会原样返回。
• WebUI 里找不到某个群接口的表单？接口 schema 是运行时从服务端拉取的，先确认机器人已登录且该接口已注册，再到接口调试页刷新。
• 操作历史存在哪里？WebUI 只负责调用，不落库，历史要自己写日志或存到自己的数据库。

建议从加群请求自动审核开始，这是见效最快、也最不容易出错的场景，跑通之后再接禁言和公告，最后把成员数据监控补上。

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ