admin
这一页说明管理员配置。admin 决定哪些 Telegram 账号可以执行管理员专属命令,以及哪些人拥有最高级别的配置操作权限。
admin
yaml
admin:
- 123456789
- 987654321说明
admin 列表里的元素既可以是数字 UID,也可以是用户名(不带 @,大小写不敏感)。两种写法都会参与匹配,建议优先用数字 UID,因为它不会变。
admin
解释
- 这是 bot 的管理员名单。
- 管理员可以执行管理员权限指令,例如
/reload、/grant、/leave等。 - 管理员指令检查逻辑会拿发起者的 UID 和用户名,分别与这个列表比对,命中任意一个就算管理员。
特性
- 类型:
list[int | str] - 实际推荐写法:
list[int] - 用户名匹配不区分大小写,写
Kala和kala效果相同。 - 用户名可以随时改,改了之后旧名字就匹配不上了,所以长期稳定的授权还是用 UID 更稳妥。
配置示例
yaml
admin:
- 123456789
- 987654321首次启动自动认主
解释
- 如果当前
admin列表为空,koipy 会进入一次性的“自动认主”流程。 - 第一个给 bot 发送私聊消息的人,会被加入管理员列表。
- 写入配置后,程序会触发一次重载 / 重启流程,让新管理员身份立即生效。
特性
- 这个自动认主流程只在“管理员列表为空”时启用。
- 它监听的是私聊消息,不是群消息。
- 一旦已经有管理员,这个引导逻辑就不会再继续注册新的管理员。
配置示例
yaml
admin: []与 user 的关系
解释
- 程序启动初始化时,会把
admin里的成员合并进user。 - 这意味着大多数情况下,管理员天然也拥有普通用户权限,不需要再重复写进
user。 - 但要注意,
/grant和/ungrant修改的是user,不是admin。
特性
- 如果你想新增普通用户,用
/grant更合适。 - 如果你想新增管理员,当前更适合直接编辑
config.yaml里的admin列表。 - 不要把“给用户授权”和“提升为管理员”混为一回事,它们是两套配置。
配置示例
yaml
admin:
- 123456789
user:
- 222222222普通用户授权指令可参考:
相关内容
