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

NapCatQQ 群组管理4 个真实场景下怎么用 OneBot 接口跑起来【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQNapCatQQ 是基于 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支持本地路径或 URLfolder指定目录返回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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考