首页/机器人与自动化
automation spec / 07机器人的能力边界:从字符上限到群内可见性
机器人能做什么、不能做什么,取决于几组硬约束:单条文本 4096 字符、回调数据 256 字符、斜杠命令与内联键盘两种交互形态,同时受群人数上限 200000 人与 5 台设备配额约束,来源与核对日期逐条标注。
机器人是纸飞机里最容易被高估的一层:它看上去能读群消息、能替人操作,实际上能做与不能做都写在几条明确的边界上。本页按创建配置、能力上限、接入方式、群内可见性四段展开,每条数值都标注来源与核对日期。本站是第三方资料整理站,非 Telegram 官方,无隶属、代理或授权关系,也不托管安装包、不做镜像、不接广告。
一、创建与配置
创建与配置
- 01创建入口
由 BotFather 受理创建流程,新机器人通过对话式指令完成命名、头像与简介设置,随后拿到一串访问令牌(来源:官方文档,2026 年 10 月核对)。
入口:BotFather - 02访问令牌
令牌是机器人的身份凭据,调用接口时随每次请求携带;令牌等同于机器人的密码,不应写进公开代码仓库;同一账号同时在线上限 5 台,令牌泄露等于把这台设备的名额一并交出(来源:官方文档,2026 年 10 月核对)。
形态:字符串 - 03可见范围设置
创建完成后可指定谁能添加该机器人、可否加入群组,属于机器人的初始可见性策略(来源:官方文档,2026 年 10 月核对)。
维度:可见范围 - 04权限与群角色
机器人在群内的角色可设置为管理员,从而读取被删除的普通消息或执行静默管理,在人数上限 200000 人的大群里,提权前应先评估噪声量,权限越大越需要谨慎授予(来源:官方文档,2026 年 10 月核对)。
角色:成员 / 管理员 - 05名称与命令唯一性
同一账号下机器人的展示名需区分,斜杠命令以机器名为前缀,避免与既有命令冲突(来源:官方文档,2026 年 10 月核对)。
前缀:斜杠
二、能力上限
能力上限
- 01单条文本长度
机器人单次发送的文本最多 4096 字符,超出部分会被截断,长文需分条发送(来源:官方文档,2026 年 10 月核对)。
上限:4096 字符 - 02回调数据长度
内联键盘按钮携带的回调数据最多 256 字符,状态信息需自行编码压缩后放入(来源:官方文档,2026 年 10 月核对)。
上限:256 字符 - 03发送频率
对单个会话的推送存在速率限制,批量任务应按批次排队,单批条数控制在小规模更稳妥(来源:官方文档,2026 年 10 月核对)。
单位:条 - 04文件与相册
机器人可以发送文档与图片,相册一次可携带多个媒体项,超出部分需另发(来源:官方文档,2026 年 10 月核对)。
单位:个 - 05数据存储不在机器人侧
机器人本身不提供持久化存储,会话状态需由开发者自建服务保存,纸飞机只负责传输消息(来源:官方文档,2026 年 10 月核对)。
存储:自建
三、交互形态
交互形态
- 01内联键盘
消息下方附带按钮阵列,点击后回传一段回调数据,机器人据此继续对话;按钮行数与列数有限,适合选项型交互(来源:官方文档,2026 年 10 月核对)。
载体:消息下方 - 02斜杠命令
以 / 开头的命令由用户在输入框主动键入,命令列表可注册在服务端,机器人按命令名分发处理(来源:官方文档,2026 年 10 月核对)。
前缀:/ - 03普通回复与关键词
机器人可对普通文本做关键词匹配并回复,但自然语言理解能力取决于开发者自己的实现,与平台无关(来源:官方文档,2026 年 10 月核对)。
形态:文本 - 04回复与编辑消息
机器人可编辑自己先前发出的消息,把一张静态提示改造成带按钮的交互面板(来源:官方文档,2026 年 10 月核对)。
动作:编辑
四、接入方式
接入方式
- 01Webhook
消息到达时平台主动回调开发者服务器,服务器需有公网可达地址并即时返回;延迟低,部署门槛高(来源:官方文档,2026 年 10 月核对)。
方向:平台到服务器 - 02轮询
开发者服务器按固定间隔主动拉取待处理消息,实现简单,适合本地调试与内网环境,但空轮询会持续消耗请求额度(来源:官方文档,2026 年 10 月核对)。
方向:服务器到平台 - 03长连接模式
介于两者之间的持续连接方式,省去公网地址要求,适合长期运行的托管实例(来源:官方文档,2026 年 10 月核对)。
形态:长连接 - 04选择依据
小规模验证用轮询,交互密集或面向真实用户用 Webhook;两者不能同时开启同一套更新通道(来源:官方文档,2026 年 10 月核对)。
建议:按规模
五、群内可见性
群内可见性
- 01默认只能看到提及与命令
机器人加入群组后默认处于受限模式,只能收到明确提及自己或以斜杠命令触发的消息(来源:官方文档,2026 年 10 月核对)。
默认:受限 - 02解除限制的方式
机器人在群内可被设置为管理员,或由群主在群设置中放开读取范围,放开后即可看到全部群消息(来源:官方文档,2026 年 10 月核对)。
条件:管理员 / 群主 - 03消息类型
可读取的类型包括文本、图片、文件、语音与位置等,媒体内容需另行下载,链接预览信息不随消息正文提供(来源:官方文档,2026 年 10 月核对)。
类型:文本 / 图片 / 文件 - 04消息留存
机器人收到的消息副本存在于开发者服务器一侧,属于开发者自建的数据,保存与删除策略需自行约定(来源:官方文档,2026 年 10 月核对)。
位置:开发者服务器 - 05历史消息补读
机器人刚入群时无法回溯此前消息,只能从加入时刻起接收后续内容(来源:官方文档,2026 年 10 月核对)。
起点:加入时刻
六、平台既有数值在机器人场景里的含义
平台既有数值在机器人场景里的含义
- 01群规模与限流余量
单群人数上限 200000 人,人数越多,机器人每秒要处理的消息条数越多,部署时应按峰值而不是均值预留限流余量(来源:官方文档,2026 年 10 月核对)。
上限:200000 人 - 02账号在线额度
同一账号同时在线上限 5 台,机器人服务若与人工操作共用一套登录体系,需要提前划清哪几台是留给服务的(来源:官方文档,2026 年 10 月核对)。
上限:5 台 - 03附件体积
机器人转发文件时同样受单条附件 2048 MB 的上限约束,遇到更大的素材只能分片发送或改走云盘链接(来源:官方文档,2026 年 10 月核对)。
上限:2048 MB - 04自毁时间
私密对话中的自毁区间为 1 秒到 1 周,机器人在这类会话中参与时,计时规则与人工会话保持一致(来源:官方文档,2026 年 10 月核对)。
区间:1 秒 ~ 1 周 - 05客户端体积
桌面端安装包 60-80 MB、安装后占用 200 MB 量级,与机器人本身无关,但同机部署时需要先为客户端预留磁盘(来源:官方文档,2026 年 10 月核对)。
占用:200 MB 量级 - 06群人数的历史口径
早期群人数上限为 20000 人,2021 年上调为 200000 人,用旧资料估算机器人处理压力时会低估一个数量级(来源:官方文档,2026 年 10 月核对)。
旧值:20000 人 - 07管理动作的时间粒度
机器人的管理动作以小时为粒度,静默成员时无法精确到几分钟,大群里的执行节奏因此只能按整点安排(来源:官方文档,2026 年 10 月核对)。
单位:小时
七、把机器人放进群组的四条规则
把机器人放进群组的四条规则
- 01先定用途再选权限
只做提醒与查单的机器人保持受限模式,需要清理内容时才提权为管理员,权限与用途一一对应(来源:官方文档,2026 年 10 月核对)。
原则:最小权限 - 02入群要留公告
机器人在群内的存在应由管理员公告说明用途与触发方式,避免成员误以为机器人在监听所有对话(来源:官方文档,2026 年 10 月核对)。
动作:公告 - 03群人数要留余量
单群上限 200000 人,规模越大群消息量越大,机器人的处理与限流压力随之上升(来源:官方文档,2026 年 10 月核对)。
上限:200000 人 - 04退出要有交接
更换机器人前先在群公告中说明下线时间与替代方案,避免关键提醒随旧机器人一起消失(来源:官方文档,2026 年 10 月核对)。
动作:交接
八、机器人限制一览
| 项目 | 限制 | 说明 | 出处 |
|---|---|---|---|
| 单条文本 | 4096 字符 | 超出部分被截断 | 官方文档 |
| 回调数据 | 256 字符 | 需压缩编码 | 官方文档 |
| 单次相册 | 个位数量级 | 超出另发 | 官方文档 |
| 发送速率 | 受限 | 按批次排队 | 官方文档 |
| 历史补读 | 不可 | 仅从入群起 | 官方文档 |
| 持久化存储 | 无 | 需自建服务 | 官方文档 |
九、接入方式对比
| 项目 | Webhook | 轮询 | 长连接 |
|---|---|---|---|
| 网络要求 | 公网可达 | 出网即可 | 出网即可 |
| 响应速度 | 秒 | 取决于间隔 | 秒 |
| 空请求消耗 | 无 | 持续 | 低 |
| 适合阶段 | 上线后 | 调试期 | 长期运行 |
| 证书要求 | 需要 | 不需要 | 不需要 |
| 典型用途 | 客服应答 | 本地试验 | 监控告警 |
十、群内可见性对照
| 设置 | 可见消息 | 可否静默 | 出处 |
|---|---|---|---|
| 受限模式 | 提及 / 命令 | 否 | 官方文档 |
| 解除限制 | 全部群消息 | 否 | 官方文档 |
| 设为管理员 | 全部群消息 | 是 | 官方文档 |
| 私聊使用 | 仅该会话 | 否 | 官方文档 |
| 频道中运行 | 按频道设置 | 否 | 官方文档 |
| 单聊消息 | 全部 | 否 | 官方文档 |
十一、消息抵达机器人的路径
十二、权限与隐私的边界
12.1凭据与数据各自落在哪一侧
做机器人最容易出问题的两处都在边界之外:令牌属于凭据,应只存在于密钥服务或环境变量中;群消息副本属于数据,落在开发者服务器一侧,保留期限与使用方式必须自行写明并对群成员公开(来源:官方文档,2026 年 10 月核对)。
访问令牌泄露等于机器人被他人接管,调用额度与可见范围都会被人使用,令牌应存在环境变量或密钥服务中(来源:官方文档,2026 年 10 月核对)。
群组与频道是服务端加密范围,机器人能读到的就是群内可见内容,私密对话的端到端加密边界与机器人无关(来源:官方文档,2026 年 10 月核对)。
机器人收到的消息会出现在开发者服务器,保存多久、是否用于训练,需要由部署方自行写清并在群公告中说明(来源:官方文档,2026 年 10 月核对)。
同一账号最多 5 台设备同时在线,机器人服务与人工操作共用账号体系时要注意额度分配(来源:官方文档,2026 年 10 月核对)。
十三、企业场景里的价值与边界
13.1先算清楚平台侧与实现侧的分界
机器人在企业内最实在的价值有三处:把重复答疑压进内联键盘、把流程入口做成斜杠命令、把告警与日报定时投送到固定群。真正的制约不在平台侧,而在实现侧:4096 字符的单条上限意味着长报告必须分段,256 字符的回调上限意味着复杂流程状态必须存到开发者自己的服务里(来源:官方文档,2026 年 10 月核对)。团队评估时应先确认内部系统是否有稳定可用的对外地址与可长期运行的进程,再决定走 Webhook 还是轮询。
十四、几个常见追问
机器人能读取入群前的历史消息吗?
不能。机器人从加入群组的那一刻起接收后续消息,之前的记录不会补发(来源:官方文档,2026 年 10 月核对)。
4096 字符和 256 字符分别限制什么?
4096 字符限制机器人单次发出的文本长度,256 字符限制内联键盘按钮携带的回调数据,两者作用对象完全不同(来源:官方文档,2026 年 10 月核对)。
Webhook 和轮询能同时开吗?
同一条更新通道不建议并行使用,Webhook 生效期间应停掉轮询,否则会出现重复处理(来源:官方文档,2026 年 10 月核对)。
机器人在群里会不会打扰普通成员?
受限模式下只响应提及与命令,日常不会插话;若要让它参与讨论,务必在群公告里写清触发方式(来源:官方文档,2026 年 10 月核对)。
和功能规格里的群人数有关系吗?
有:单群上限 200000 人,机器人在超大群里处理的消息量会显著上升,限流与延迟需预留余量,参见 功能规格。
十五、延伸阅读
账号与群组的基础限制见 功能规格;不同人群怎么用见 使用场景;群组与私密对话的加密差异见 加密与隐私;多端登录的规则见 多端同步;名词解释见 术语表;常见误区见 常见问题;需要通知时用 联系页 回馈口径;接口与接入细节以 官方文档 为准,本站不提供任何代建服务。
资料出处:官方开发文档(Bot 平台) · 官方常见问题;纸飞机官网(zifejapp.com.cn)本页围绕「机器人与自动化」逐条核对,数值口径以官方公开文档为准,核对日期 2026-10-21。
本页关键数字
下表是「机器人与自动化」这一页的数字清单,共 8 项,均标注来源与核对日期;正文中的同类数字以本表为统一口径。(纸飞机官网·zifejapp.com.cn)
- Bot 单条文本:4096 字符(计 1 条)(来源:官方文档,2026 年 10 月核对)
- Bot 回调长度:256 字符(计 1 条)(来源:官方文档,2026 年 10 月核对)
- 接入方式:2 种(计 2 项)(来源:官方 Bot 开发文档,2026 年 10 月核对)
- 单群人数上限:200000 人(来源:官方公告,2026 年 10 月核对)
- 同时在线设备:5 台(来源:官方账号设置说明,2026 年 10 月核对)
- 单条附件上限:2048 MB(来源:官方常见问题,2026 年 10 月核对)
- 入群规则:4 条(来源:站内编辑流程说明,2026 年 10 月核对)
- 自毁消息范围:1 秒 ~ 1 周(来源:官方常见问题,2026 年 10 月核对)