入群管理员检测

AstrBot 插件：机器人被拉入新群后（OneBot v11 的 group_increase 事件），自动检查指定的机器人管理员是否在群成员列表中。

兼容性

支持 AstrBot v4.27.4 及以上版本。

当前为 v1.0.9，修复入群通知不触发的问题，改用自定义事件过滤器精确匹配 NapCat 入群通知，全程不调用 LLM。

v1.0.8 增加显式 @star.register，兼容旧版 AstrBot 加载器。

v1.0.7 改为直接挂载 NapCat on_notice 回调，绕过 AstrBot 空通知事件的唤醒流程。

功能

• 监听机器人自身入群事件
• 只处理机器人自己入群，不处理普通成员入群
• 自动获取群成员列表
• 检查配置中的机器人管理员 QQ 号
• 管理员已在群内：保持静默
• 管理员不在群内：自动 @ 邀请机器人入群的人
• 邀请人存在时使用真实 @ 组件
• 找不到邀请人时发送纯文字提醒
• 支持 AstrBot 插件配置面板填写管理员 QQ 和提醒模板
• 全程不调用 LLM，仅检测管理员 QQ 是否已在群内
• 无需任何用户指令
• 不依赖第三方库

安装

在 AstrBot WebUI 的插件管理中填写仓库地址：

https://github.com/Zxin-Pro/astrbot_plugin_join_admin_request

也可以把整个仓库目录复制到：

AstrBot/data/plugins/astrbot_plugin_join_admin_request/

然后重载插件或重启 AstrBot。

配置

编辑插件目录下的 config.json：

{
  "admin_ids": [
    "123456789"
  ],
  "message": "{inviter_at}，你好，请把机器人管理员（{admin_ids}）也拉进群，谢谢！"
}

配置字段

• admin_ids：机器人管理员 QQ 号列表，支持多个
• message：管理员不在群内时发送的提醒内容
• {inviter_at}：会被替换为真实邀请人 @；找不到邀请人时替换为“邀请人”
• {inviter_name}：邀请人昵称
• {admin_ids}：配置中的机器人管理员 QQ 号列表

修改 config.json 后，重载插件即可生效。

工作流程

1. 机器人被拉入群或通过邀请入群；
2. 插件确认入群者是机器人自身；
3. 获取该群成员列表；
4. 检查 admin_ids 中是否有管理员在群内；
5. 有管理员则不发送消息；
6. 没有管理员则提醒群主。

文件说明

astrbot_plugin_join_admin_request/
├── main.py          # 插件本体
├── config.json      # 管理员 QQ 和自定义消息
├── metadata.yaml    # AstrBot 插件元数据
├── README.md        # 使用说明
└── CHANGELOG.md     # 更新日志

注意

插件需要平台适配器支持获取群成员列表和发送群消息。OneBot/aiocqhttp 平台通常需要机器人具备相应的群权限。