koishi-plugin-auto-exit-group 自动退群管家

🤖 项目介绍#

koishi-plugin-auto-exit-group 是一款 Koishi 群组管理插件（仅限 OneBot 平台），基于白名单机制帮助机器人自动清理群组：定时检查机器人所在的群列表，自动退出未加入白名单的群。对于被频繁拉群、群数量失控的机器人来说，这是一个非常实用的”瘦身”工具。

⭐ 开源地址：https://github.com/opwop1/koishi-plugin-auto-exit-group

✨ 功能特性#

• 定时自动检查：按配置间隔自动检查机器人所在群列表并退出未白名单群
• 白名单机制：只保留配置中列出的群，其余全部退出
• 多实例支持：支持多个 OneBot 适配器实例同时使用
• 启动即检查：机器人启动时立即执行一次检查
• 手动指令：提供手动触发检查与查看白名单的命令

⚙️ 配置项#

1
plugins:
2
  auto-exit-group:
3
    allowedGroups:
4
      - "123456789"
5
      - "987654321"
6
    interval: 30
7
    enabled: true

📋 指令说明#

📝 使用步骤#

1. 配置白名单：在 Koishi 控制台的插件配置中，将需要保留的群号添加到 allowedGroups
2. 启用插件：确保 enabled 配置项为 true
3. 设置间隔：根据需要设置 interval，默认 60 分钟检查一次

⚠️ 注意事项#

1. 仅支持 OneBot 平台：本插件仅适用于 OneBot（如 go-cqhttp、NapCat 等）适配器
2. 谨慎配置白名单：如果白名单为空，机器人将退出所有群！请在启用前确认白名单配置正确
3. 权限要求：机器人需要有退出群聊的权限
4. 日志查看：可通过 Koishi 控制台日志了解退群情况

📄 许可证#

MIT License