NapCatQQ 群组管理：6 个场景接管群务

发布时间：2026/11/4 11:53:39

NapCatQQ 群组管理：6 个场景接管群务

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

加群请求不断涌来、广告消息要撤回、每周公告要手动发，人肉操作容易掉链子。NapCatQQ 群组管理把这些重复动作交给 Bot 层完成，接口在协议侧秒级执行。下面按群管场景拆开讲：每个动作对应哪个 action、入口在哪里。

🔐 自动处理加群请求与禁言

新成员多的群，最先值得记住的是set_group_add_request：传入 flag、是否同意和拒绝理由，一次调用处理一条请求；count 参数（默认 100）可以批量拉取待处理项，配合简单规则就能成批同意或拒绝，把 NapCatQQ 自动审核入群变成固定流程。注意 flag 有有效期，建议在收到加群请求事件后立刻处理。接口同时覆盖"加群申请"与"群邀请"两种入口，都走同一个 flag。

请求体长这样：

{ "action": "set_group_add_request", "flag": "9007199254740991", "approve": true }

权限管理是同一批接口：

set_group_admin设置或取消群管理员
set_group_ban按时长禁言单个成员，set_group_whole_ban全员禁言
set_group_kick移出群，set_group_card修改成员名片
set_group_name修改群名称

这些 action 在 packages/napcat-onebot/action/group/ 下每个 action 一个源文件，内含参数 schema 与示例，排查参数时直接翻文件即可。

🧹 一键撤回消息、设精华与标记已读

内容治理里使用频率最高的三个动作：

delete_msg按 message_id 撤回或删除群消息
set_essence_msg与del_essence_msg设置、取消群精华
mark_msg_as_read标记群消息已读，参数只需 group_id 与 message_id

它们和收群消息事件组合后，你可以先匹配消息内容再调用对应接口，内容治理就从"人肉巡逻"变成"事件驱动"。另外，Bot 需要具备相应的群管理权限，否则撤回、禁言类调用会直接失败。

📁 上传群文件并生成下载链接

NapCatQQ 群文件管理覆盖从上传到分发的完整链路：

upload_group_file把本地文件传到群文件空间
create_group_file_folder建文件夹归类
get_group_root_files与get_group_files_by_folder查根目录和子文件夹内容
get_group_file_system_info查看群文件空间配额
get_group_file_url返回某个文件的下载链接，可直接转发给成员

最后一条最值得用：配合定时器，你可以按时推送资料，成员不用再来找链接要地址。实现见 packages/napcat-onebot/action/file/GetGroupFileUrl.ts，返回结构里只有url一个字段，很好取。WebUI 也内置了文件管理页，适合不用写代码时的可视化操作。

📢 定时推送群公告与查询历史公告

公告管理是三个接口的组合：send_group_notice发新公告，get_group_notice查当前群公告，del_group_notice删除公告。覆盖前建议先 get 一次现有内容，避免误删别人维护中的公告。公告接口常和定时器搭配：周一推周报、活动前推通知，都是几行规则就能落地的场景。

🏆 拉取荣誉榜与活跃成员

get_group_honor_info一次返回六类荣誉数据：current_talkative 当前龙王与 talkative_list 龙王列表、performer_list 群聊之火与 legend_list 群聊炽热、emotion_list 快乐源泉、strong_newbie_list 冒尖小春笋。只传 group_id 即取全量榜单，也可以按 type 指定拉某一类。

再配合get_group_member_list拉成员列表、get_group_info拉群基础信息，你做一份简单的群活跃统计就够用了；数据拿到手，周末把荣誉变化直接发回群里，成员感知度会好很多。