主机器人管理

总览

机器人系统的实时状态,一屏看完

机器人系统
群组 / 频道
0 个群 · 0 个频道
0 个机器人在线
群成员总数
0
+0 今日新增
今日消息
0
已拦截垃圾消息 0 条
待验证用户
0
0 人即将超时被移出

今日发送量

按小时统计 · 机器人群管消息
群管 0
03691215182124

群组状态

群组机器人成员状态
暂无群组

最近告警

暂无告警

待处理

需要你确认或补配置
订阅门槛未通过的成员0
待审批进群申请0
未绑定机器人的群0

主机器人

执行门槛提醒与频道管理:订阅门槛检测放行、频道同步、定时消息播报;下面三个标签页是违禁词与自动删除、进群欢迎、自动回复,默认全关着,打开一条生效一条

已接入 0 个

管门槛提醒与频道;下面三页默认全关着
暂无主机器人 —— 点右上角「添加主机器人」
共 0 台 · 在线 0 · 离线 0。所在群由机器人实时上报:进群马上出现,退群马上删掉。
一个机器人能管几个群

技术上一个机器人可以同时服务几十个群,没有数量限制。之所以做「一群一主机器人 + 池」,是为了单点故障时不影响其他群,并且把消息速率分摊开。

速率上限

Telegram 对机器人发消息的限制约为:单个群 20 条 / 分钟,全局 30 条 / 秒。定时消息和频道同步会按这个上限自动排队。

Token 安全

Token 加密后存数据库,页面只显示后 4 位。后台账号分为超管 / 运营 / 客服三级,只有超管能查看和更换 Token。

副机器人

执行群组管理:违禁词与自动删除、进群欢迎、自动回复、群清理;下面三个标签页是这三项设置,打开一条生效一条

已接入 0 个

管群里的清理、欢迎与回复
暂无副机器人 —— 点右上角「添加副机器人」
共 0 台 · 在线 0 · 离线 0。所在群由机器人实时上报:进群马上出现,退群马上删掉。
主副各一套配置

副机器人读的是自己那三张设置页(违禁词与自动删除、进群欢迎、自动回复),跟主机器人那套完全分开存:改副机器人不影响主机器人,改主机器人也不影响副机器人。

可以同时进群

主机器人和副机器人可以同时在同一个群里干活,也可以只放一台。重复的功能(比如两边都开了进群欢迎)自己决定关哪一边,关掉就只留一边发。

角色随时可换

卡片右上角三个点里可以「设为主机器人 / 设为副机器人」,换完下一轮轮询就按新角色读对应的那套配置,不用重新加机器人。

群组与频道

共 0 个群、0 个频道。每个群都要绑定一台机器人,频道用于订阅门槛和同步

群组 0
频道 0
已失效 0
群组Chat ID成员机器人订阅门槛状态操作
暂无群组,点右上角「添加群组」开始配置

频道列表

用于订阅门槛与频道同步
频道类型订阅数机器人权限状态
暂无频道

检测结果

机器人权限自检
删除消息权限0 / 0
封禁用户权限0 / 0
邀请用户权限0 / 0
置顶消息权限0 / 0
频道管理员0 / 0
还没有绑定群组或频道,添加后点「重新检测」检查机器人权限

订阅门槛

进群不禁言,第一次发言时删掉消息并 @ 他提示订阅,检测到已订阅自动放行

需要订阅的频道

机器人常驻在这些频道里,实时检测加入和退出
还没有需要订阅的频道,点下面按钮添加
机器人池有几个机器人就检查几个;加入或退出频道后自动更新。机器人不能自己进频道,需要你手动拉进频道并设为管理员

触发规则 · 自己群

只在第一次发言时拦一次
进群不限制;等他发第一条消息,机器人删掉后按这里的方式处理
用户在频道退订,机器人会收到事件并马上恢复限制
条 / 秒内 → 禁言
这个秒数内被删够这么多条就禁言,条数填 0 = 不启用
订阅频道后自动解除禁言;需要机器人有「限制成员」权限
可用变量:{name} 提及(自动生成真正的 @,有用户名显示 @用户名,无用户名用文本提及,对方会收到通知)、{group} 群名、{count} 还需订阅数量、{channels} 还差的频道名、{punish} 惩罚(按下面配置自动生成);支持加粗 <b>文字</b>。惩罚这一行由系统按配置自动生成,不用手写
还没有按钮,点下面按钮添加
左边填按钮名字,中间填点击后跳转的链接,右边选它在第几行;同一行的按钮会并排显示
已订阅的频道不会显示按钮;用户订阅一个就实时去掉一个,全部订阅完提醒自动删除

成员看到的效果

自己群
主
群组名称0 名成员
大家好
消息已被删除
群管机器人
@成员 {name} 请先关注如下频道或加入群组后才能发言 <b>惩罚</b>:{punish}
订阅按钮示例
10:24 ✓✓
订阅频道后即可发言…

放行流程

自己群
1 · 进群不禁言,正常欢迎
2 · 首次发言立即删除消息
3 · @ 他带订阅频道按钮
4 · 订阅频道机器人自动检测(无需点按钮)
5 · 自动放行之后正常发言
6 · 提醒卡片3 分钟后自动删除
7 · 未订阅时每条都删并提醒(窗口内不重复刷屏)
8 · 退订后恢复限制

触发规则 · 别人群

机器人在别人的群里:第一条按「首条消息处理」,之后按「未订阅时」
第一条按这里处理;之后的发言按下面「未订阅时」处理
提醒卡片到点自己消失,不在别人的群里刷屏
只对被禁言过的人有效,没禁言过的人不受影响
次 → 禁言
同一个人被提醒够这么多条才禁言,填 0 = 只提醒不禁言;普通群不支持限时禁言,会自动跳过
同一个人被提醒够上面这个次数才禁言;填 0 = 只提醒
可用变量:{name} 提及(自动生成真正的 @,有用户名显示 @用户名,无用户名用文本提及,对方会收到通知)、{group} 群名、{count} 还需订阅数量、{channels} 还差的频道名、{punish} 惩罚(按下面配置自动生成);支持加粗 <b>文字</b>。惩罚这一行由系统按配置自动生成,不用手写
还没有按钮,点下面按钮添加
左边填按钮名字,中间填点击后跳转的链接,右边选它在第几行;同一行的按钮会并排显示
已订阅的频道不会显示按钮;用户订阅一个就实时去掉一个,全部订阅完提醒自动删除

成员看到的效果

别人群
群
群组名称0 名成员
大家好
群管机器人
@成员 {name} 请先关注如下频道或加入群组后才能发言 <b>惩罚</b>:{punish}
订阅按钮示例
10:24 ✓✓
订阅频道后即可发言…

放行流程

别人群
1 · 进群不禁言,正常欢迎
2 · 首次发言保留消息,只 @ 他提醒
3 · @ 他带订阅频道按钮
4 · 订阅频道机器人自动检测(无需点按钮)
5 · 自动放行之后正常发言
6 · 提醒卡片30 秒后自动删除
7 · 未订阅时每条都删并提醒(窗口内不重复刷屏)
8 · 退订后恢复限制

待订阅成员

未订阅的人第一次发言后会出现在这里
用户所在群还缺首次发言状态操作
暂无待订阅成员,开了门槛后未订阅的人会出现在这里
检测到成员已订阅频道后会自动消失;点「放行」也可以直接放开一个人。

进群欢迎

自定义文字、图片或视频、按钮,新成员进群自动发送

欢迎内容

变量:{name}(新人真实用户名,发出去就是 @提到他){group}(群名){count}(群成员数){date};没设用户名的成员不发欢迎语
支持 JPG / PNG / MP4,视频不超过 20MB
按钮
还没有按钮,点下面按钮添加
欢迎语发出去后到点自动删除;选「永久保留」就一直留在群里
总开关

效果预览

主
群组名称0 名成员
群管机器人
在左边写好欢迎文字后,这里会实时预览成员看到的效果
10:24 ✓✓
输入消息…

生效群组

只列群,频道不发欢迎语;总开关和这里的开关都打开,才会发欢迎语
群群号欢迎语
还没记录到群 —— 把机器人拉进群、在群里发一句话就会出现在这里
总开关关掉时这里的开关跟着全部关闭;总开关打开后,原来开着的群自动恢复,只有开着开关的群才会收到欢迎语

违禁词与自动删除

命中词库或触发下面的规则,机器人自动删消息、按累进处罚处理,不用人工盯着

自动删除规则

打开一条生效一条
违禁词
命中词库,删消息并累进处罚
已启用
广告 / 拉人
发广告、拉人话术,删消息并处理发的人
已启用
带 @ 的消息
@用户名、@所有人
已启用
带 http / https
消息里有网页链接
已启用
带 t.me / tg://
频道、群、机器人链接
已启用
群里进了机器人
有机器人被拉进群,直接踢出
已启用
刷屏
同一个人 1 分钟内发 5 条以上
未启用
超长消息
超过 1000 字
未启用
机器人需要「删除消息」和「踢人」权限,规则才会真的生效

系统消息清理

进群退群这类提示
成员进群通知
「xxx 加入了群组」
已启用
成员退群通知
「xxx 离开了群组」
已启用
修改群头像 / 群名
管理员改群信息时产生的提示
已启用
置顶消息提示
「xxx 置顶了一条消息」
已启用
视频聊天开始 / 结束
群语音视频的系统提示
已启用
管理员操作提示
话题创建 / 关闭、自动删除计时变更这类提示
未启用

删除延迟

给成员留几秒看到
违规消息是立即删除的,延迟只对系统提示消息生效
建议保留 3 秒延迟。立即删除时,成员有时会看到消息闪一下,体验不好。

违禁词词库

加一个生效一个
还没有违禁词,在上方输入添加;加一个生效一个

处罚策略

累进
第 1 次警告 + 撤回消息
第 2 次禁言 1 小时
第 3 次禁言 24 小时
第 4 次移出群聊
第 5 次永久封禁
群里那条「【违规处理】… 本次处理:…」;撤回、禁言、踢人照常执行

白名单

不检测
白名单为空,所有账号都受规则约束

最近命中记录

时间用户群组命中消息内容处罚
暂无命中记录,群消息命中规则后会自动出现在这里
每页 10 条

自动回复

关键词触发回复,支持精确、包含、正则三种匹配

规则列表

打开一条生效一条
关键词匹配方式回复内容冷却今日触发状态操作
暂无自动回复规则,在下方新建一条

新建 / 编辑规则

回复效果

主
群组名称0 名成员
关键词
群管机器人
在左边填好关键词与回复内容后,这里会预览回复效果
10:24 ✓✓
输入消息…

违禁词与自动删除

主机器人专用的一套:规则、词库、白名单、命中记录都单独存,跟副机器人那套互不影响

自动删除规则

打开一条生效一条
违禁词
命中词库,删消息并累进处罚
已启用
广告 / 拉人
发广告、拉人话术,删消息并处理发的人
已启用
带 @ 的消息
@用户名、@所有人
已启用
带 http / https
消息里有网页链接
已启用
带 t.me / tg://
频道、群、机器人链接
已启用
群里进了机器人
有机器人被拉进群,直接踢出
已启用
刷屏
同一个人 1 分钟内发 5 条以上
未启用
超长消息
超过 1000 字
未启用
主机器人需要「删除消息」和「踢人」权限,规则才会真的生效

系统消息清理

进群退群这类提示
成员进群通知
「xxx 加入了群组」
已启用
成员退群通知
「xxx 离开了群组」
已启用
修改群头像 / 群名
管理员改群信息时产生的提示
已启用
置顶消息提示
「xxx 置顶了一条消息」
已启用
视频聊天开始 / 结束
群语音视频的系统提示
已启用
管理员操作提示
话题创建 / 关闭、自动删除计时变更这类提示
未启用

删除延迟

给成员留几秒看到
违规消息是立即删除的,延迟只对系统提示消息生效
建议保留 3 秒延迟。立即删除时,成员有时会看到消息闪一下,体验不好。

违禁词词库

加一个生效一个
还没有违禁词,在上方输入添加;加一个生效一个

处罚策略

累进
第 1 次警告 + 撤回消息
第 2 次禁言 1 小时
第 3 次禁言 24 小时
第 4 次移出群聊
第 5 次永久封禁
群里那条「【违规处理】… 本次处理:…」;撤回、禁言、踢人照常执行

白名单

不检测
白名单为空,所有账号都受规则约束

最近命中记录

时间用户群组命中消息内容处罚
暂无命中记录,主机器人拦到违规消息后会出现在这里
每页 10 条

进群欢迎

主机器人专用的一套欢迎配置:文字、图片或视频、按钮,只由主机器人发送

欢迎内容

变量:{name}(新人真实用户名,发出去就是 @提到他){group}(群名){count}(群成员数){date};没设用户名的成员不发欢迎语
支持 JPG / PNG / MP4,视频不超过 20MB
按钮
还没有按钮,点下面按钮添加
欢迎语发出去后到点自动删除;选「永久保留」就一直留在群里
总开关

效果预览

主
群组名称0 名成员
主机器人
在左边写好欢迎文字后,这里会实时预览成员看到的效果
10:24 ✓✓
输入消息…

生效群组

只列主机器人所在的群;总开关和这里的开关都打开,才会发欢迎语
群群号欢迎语
还没记录到主机器人所在的群 —— 把主机器人拉进群、在群里发一句话就会出现在这里
总开关关掉时这里的开关跟着全部关闭;总开关打开后,原来开着的群自动恢复

自动回复

主机器人专用的一套回复规则:关键词触发回复,只由主机器人执行

规则列表

打开一条生效一条
关键词匹配方式回复内容冷却今日触发状态操作
主机器人还没有自动回复规则,在下方新建一条

新建 / 编辑规则

回复效果

主
群组名称0 名成员
关键词
主机器人
在左边填好关键词与回复内容后,这里会预览回复效果
10:24 ✓✓
输入消息…

定时消息

写一条内容,每天按北京时间发到下面开着开关的每个群/频道

新建定时消息

每天定时 · 北京时间 · 每个群只发一条
可以纯文案、纯图片、纯视频,也可以图文加按钮一起发
每个按钮选它所在的第几行,选同一行的会并排显示
:
今天已经过去的时间点不会补发,会等到明天这个点
群
群消息预览机器人发送效果
(文案为空)
08:00
输入消息…
按钮同行或换行,预览会跟着变
测试只发 1 条到群列表里第一个开着的群/频道,看着没问题再保存

发送到哪些群 / 频道

关掉的不发;同一个群只发一条
群 / 频道链接类型发送
还没记录到群/频道 —— 把机器人拉进群、在群里发一句话就会出现在这里

已设置的文案

胶囊关掉就停发,打开就继续按时间发
文案发送方式开启操作
还没有定时消息,在上方写好内容后点「保存并开启」

频道同步

源频道发一条,自动同步到多个频道和群组,不用复制粘贴

新建同步任务

源频道发什么,目标就有什么;相册整组一起走
填频道 ID,以 -100 开头;机器人要是源频道的管理员
一个源频道可以同步到多个频道或群,每行填一个 ID
机器人必须已经在源频道和目标频道里,并且是管理员,否则发不进去
开启:从源频道第一条开始,把以前的全部搬过来;关闭:只同步保存之后发的新消息
开启:目标里显示「转发自 源频道」;关闭:复制过去,看不到来源,受保护频道也能用

已设置的同步

胶囊关掉就停止同步,打开就继续;「显示来源」那格点一下就能切
源频道 → 目标频道同步历史显示来源状态消息开启操作
还没有同步任务,在上方填源频道与目标频道后保存
同步由机器人完成,机器人在几个频道就同步几个频道;相册算 1 组,源里改过的消息目标也跟着改(删除跟不了)

修改按钮

已发布的消息,点编辑直接改文字和按钮,成员看到的还是原来那条

消息群 / 频道按钮发送时间操作
共 0 条 · 每页 30 条

后台账号与角色

谁能登录后台、能看哪些页面、能做哪些操作

后台账号

0 个
账号角色绑定 Telegram两步验证最后登录状态操作
暂无数据

新增后台账号

建议所有账号都开启两步验证。绑定 Telegram ID 后,可以用机器人发验证码找回密码。

角色权限矩阵

功能超管运营客服
查看总览✓✓✓
群管规则配置✓✓—
查看机器人 Token✓——
删除账号 / 清空数据✓——

系统设置

全局参数,影响机器人的运行

基础

数据库

只读展示,修改请改 .env
连接状态未连接
主机127.0.0.1:3306
库名qunguan5
表数量—
字符集utf8mb4
建表脚本在项目根目录 schema.sql,只含 CREATE TABLE,不含建库语句

Telegram 全局

风控与限流

这三项不建议调高。加群过快、同群发太密是被踢和接口限流最直接的原因。

通知

安全

操作日志

谁在什么时候改了什么,全部留痕

日志

保留 180 天
时间操作人模块操作对象IP
暂无日志

数据备份

备份数据库和配置,换服务器时直接搬

备份记录

保留最近 7 份
文件名类型大小时间操作
暂无备份记录,点右上角「立即备份」生成第一份

自动备份

建议同时手动下载一份放本地
恢复备份会覆盖当前数据库,操作前系统会要求输入密码二次确认,并自动先做一次当前数据备份。
群管机器人
管理员登录