机器人池

总览

机器人系统与推广系统的实时状态，一屏看完

机器人系统
群组 / 频道
0 个群 · 0 个频道
0 个机器人在线
群成员总数
0
+0 今日新增
今日消息
0
已拦截垃圾消息 0 条
待验证用户
0
0 人即将超时被移出
推广系统
在役账号
0 / 0
在线 0 · 封号 0
目标群
0
可用 0 · 备用池 0
今日广告发送
0
— 成功率 · 失败 0
异常群
0
禁言 0 · 需验证 0 · 已失效 0

今日发送量

按小时统计 · 广告 + 群管消息
广告 0 群管 0
03691215182124

群组状态

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

最近告警

暂无告警

待处理

需要你确认或补配置
订阅门槛未通过的成员0
待审批进群申请0
未绑定机器人的群0
无可用代理的账号0
补位失败的群0

机器人池

一个群绑定一个主机器人，主机器人离线时由池内其他机器人顶上。功能设置对全部机器人统一生效，不用逐个配置

已接入 0 个

池容量无上限
机器人Token绑定群组今日消息限流余量状态操作
暂无机器人，点右上角「添加机器人」开始接入
共 0 条 · 在线 0 · 离线 0。单个机器人可以同时服务多个群，池子扩容后新群直接绑定即可。
一个机器人能管几个群

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

速率上限

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

Token 安全

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

群组与频道

共 0 个群、0 个频道。每个群必须绑定一个主机器人，频道用于订阅门槛和同步

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

频道列表

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

检测结果

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

订阅门槛

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

进群不限制发言，也不会立刻禁言。只有在他第一次发言时，机器人才会删掉那条消息并 @ 他提醒订阅。本页最上面指定的频道，机器人会自己加入并常驻，随时知道谁进了频道、谁退出了。

需要订阅的频道

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

触发规则

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

成员看到的效果

实时预览
主
群组名称0 名成员
大家好
消息已被删除
群管机器人
@成员 请先关注指定频道后才能发言（提醒文案与按钮在左边配置，这里实时跟随变化）
惩罚：仅删除
订阅按钮示例
10:24 ✓✓
订阅频道后即可发言…

放行流程

1 · 进群不禁言，正常欢迎
2 · 首次发言立即删除消息
3 · @ 他带订阅频道按钮
4 · 订阅频道机器人自动检测（无需点按钮）
5 · 自动放行之后正常发言
6 · 退订恢复限制
进群时的欢迎消息里也可以带同样的订阅提示，甚至直接放两个按钮，欢迎语在「进群欢迎」页配置。

待订阅成员

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

进群欢迎

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

欢迎内容

变量：{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 ✓✓
输入消息…

定时消息

写一条内容，机器人池里所有机器人同时发到各自所在的群或频道

新建定时消息

机器人池全部机器人同时发送
可以纯文案、纯图片、纯视频，也可以图文加按钮一起发
每个按钮选它所在的第几行，选同一行的会并排显示
群
群消息预览机器人发送效果
（文案为空）
08:00
输入消息…
按钮同行或换行，预览会跟着变
机器人池有几个机器人就同时发几个，在几个群就发几个群

已设置的文案

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

频道同步

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

新建同步任务

填频道 ID，机器人账号在几个频道就同步几个频道
填频道 ID，以 -100 开头
一个源频道可以同步到多个频道或群，每行填一个 ID
机器人必须已经在源频道和目标频道里，否则没法转发

已设置的同步

胶囊关掉就停止同步，打开就继续
源频道 → 目标频道状态消息开启操作
还没有同步任务，在上方填源频道与目标频道后保存
同步由机器人完成，机器人在几个频道就同步几个频道

修改按钮

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

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

账号池

推广用的 Telegram 个人号，支持随时补号，单号加群上限 450（留 50 缓冲）

账号总数
0
容量无上限，可随时补位
在线可用
0
正常发送中
受限 / 禁言
0
等待自动恢复
已封 / 掉线
0
需要重新登录

账号列表

0 个
序号账号状态代理已加群今日加群今日发送健康分最后活跃操作
暂无账号，点右上角「添加账号」开始导入
共 0 个账号。账号移出后序号即释放：新添加的账号优先补进最小的空缺序号（如移出 4 号，下次新增的就是 4 号）。
导入方式

支持三种：手机号 + 验证码在线登录、导入已有 session 文件、导入 tdata 目录。验证码在后台弹窗里输入，不需要命令行。

加群配额

Telegram 单号加群硬上限 500，系统按 450 分配。新号每日 10–20 个，老号 30–50 个，超限自动排队到第二天。

代理要求

一个 IP 最多挂 2 个号。同 IP 多号是最快的团灭方式，系统会在绑定时直接拦截。

API 应用池

登录 Telegram 账号需要的 api_id 和 api_hash，建议每 20–30 个号换一个应用

新增应用

应用列表

0 个应用 · 0 个账号
序号api_idapi_hash绑定账号状态
暂无应用，在上面填 api_id 后点「保存」添加

代理池

每个账号绑定独立 IP，这是降低封号率最关键的一项

代理总数
0
已绑定 0 · 空闲 0
连通正常
0
平均延迟 —
延迟偏高
0
超过 800ms
失效
0
需要更换

代理列表

开启后自动平均分配给账号 · 一个 IP 最多 2 个号
地址协议地区绑定账号延迟到期状态操作
暂无代理，点右上角「添加代理」开始

为什么必须用代理

Telegram 会看登录 IP。100 个号从同一个 IP 出去，基本等于告诉对方「这是一批机器号」。更现实的问题是一个号被限制后，同 IP 的其他号会被连带风控。

建议每个号一个独立 IP，或者最多两个号共用一个 IP，并且优先用住宅 IP 而不是机房 IP。

目标群池

要推广的群，系统自动记录每个群的禁言、需验证、被踢情况

目标群总数
0
可正常发广告
0
入驻账号满员 0 个
部分账号被禁言
0
已自动补位 0 个
无法自动验证 / 已失效
0
已移出任务 0 个

群列表

0 个
群组成员入驻账号可发账号验证群状态被踢率最后巡检操作
暂无目标群，点右上角「导入群组」开始
补位、换号、禁言退群全部由系统自动判断执行，无需手动操作；点行内「详情」可以看这个群里现在有哪些号。

广告文案

文案写进池子，系统按「每条文案 × 每个号 × 一天发几遍」等距铺开 24 小时：遍与遍严格隔固定时长，同群绝不连着刷同一条广告词，同一个号跨群自动避让；轮值计划和每条文案的详情随设置实时更新

编辑广告文案

保存后进下面列表立刻参与轮值
点击选择图片或视频（JPG / PNG / MP4）
发送时变量自动替换：{群名} {账号名} {日期}
保存后轮值计划和每个群的详情马上重算

轮值计划

换群、增删文案、开关、改遍数任一变化马上重算

文案列表

共 0 条
「详情」看这条文案在每个群当天的完整计划；关掉或删除一条，轮值立刻重算
广告文案附图防查重节奏轮值操作
暂无文案，在左边写好文案点「保存文案」开始
轮值规则：每条文案每个号一天发几遍由上面下拉选（默认 2 遍）——一天等距切成 N 段，第 2 遍是第 1 遍整体平移：如今晚 00:00 发一遍，明天中午 12:00 发第二遍，严格隔 12 小时；每段内不同文案穿插轮换、均匀铺开，任何时刻都不会连着刷同一条广告词；同一个号驻多个群按时间自动避让，同一时刻绝不在两个群同时发；次日到点开启新一轮全部重新洗牌。实际发送每个点随机延后 0~10 分钟，像真人手点；防查重再把文字打散，抓不到固定模式。

私聊回复

别人私聊推广账号时，自动回同一句话

总回复
0
自启用以来累计
回复成功
0
已送达对方
回复失败
0
对方屏蔽或账号受限

回复内容

所有账号共用这一条
不管对方发什么，都只回这一句，不做多套话术
防止对方连发几条被连续回复
所有账号回复的内容完全一样

效果预览

?
对方私聊你的推广账号时
在吗？怎么联系你
在左边写好回复内容后，这里显示自动回复效果
10:24
输入消息…

后台账号与角色

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

后台账号

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

新增后台账号

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

角色权限矩阵

功能超管运营客服
查看总览✓✓✓
群管规则配置✓✓—
查看机器人 Token✓——
推广账号管理✓✓—
处理兑换订单✓✓✓
查看私聊✓✓✓
删除账号 / 清空数据✓——

系统设置

全局参数，影响两个系统的运行

基础

数据库

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

Telegram 全局

风控与限流

这四项不建议调高。加群过快、同群发太密是被踢和封号最直接的原因。

通知

安全

操作日志

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

日志

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

数据备份

备份数据库和账号 session，换服务器时直接搬

备份记录

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

自动备份

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