纸飞机官网
口径日期 2026-10-21 第三方资料整理站 · 非 Telegram 官方 共 11 个页面 sitemap · RSS · 反馈

首页/机器人与自动化

automation spec / 07机器人的能力边界:从字符上限到群内可见性

机器人能做什么、不能做什么,取决于几组硬约束:单条文本 4096 字符、回调数据 256 字符、斜杠命令与内联键盘两种交互形态,同时受群人数上限 200000 人与 5 台设备配额约束,来源与核对日期逐条标注。

机器人是纸飞机里最容易被高估的一层:它看上去能读群消息、能替人操作,实际上能做与不能做都写在几条明确的边界上。本页按创建配置、能力上限、接入方式、群内可见性四段展开,每条数值都标注来源与核对日期。本站是第三方资料整理站,非 Telegram 官方,无隶属、代理或授权关系,也不托管安装包、不做镜像、不接广告。

先看口径:单条文本 4096 字符,回调数据 256 字符,这是两个独立的量纲,一个限制发出去的话有多长,一个限制按钮背后能挂多少标识(来源:官方文档,2026 年 10 月核对)。

一、创建与配置

创建与配置

  • 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 月核对)。

    动作:编辑

四、接入方式

接入方式

  • 01
    Webhook

    消息到达时平台主动回调开发者服务器,服务器需有公网可达地址并即时返回;延迟低,部署门槛高(来源:官方文档,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 月核对)。

    动作:交接

八、机器人限制一览

表 1 · 机器人的关键数值约束(核对日期 2026-10-21)
项目限制说明出处
单条文本4096 字符超出部分被截断官方文档
回调数据256 字符需压缩编码官方文档
单次相册个位数量级超出另发官方文档
发送速率受限按批次排队官方文档
历史补读不可仅从入群起官方文档
持久化存储无需自建服务官方文档

九、接入方式对比

表 2 · Webhook、轮询与长连接的差异(核对日期 2026-10-21)
项目Webhook轮询长连接
网络要求公网可达出网即可出网即可
响应速度秒取决于间隔秒
空请求消耗无持续低
适合阶段上线后调试期长期运行
证书要求需要不需要不需要
典型用途客服应答本地试验监控告警

十、群内可见性对照

表 3 · 不同可见性设置下机器人能收到什么(核对日期 2026-10-21)
设置可见消息可否静默出处
受限模式提及 / 命令否官方文档
解除限制全部群消息否官方文档
设为管理员全部群消息是官方文档
私聊使用仅该会话否官方文档
频道中运行按频道设置否官方文档
单聊消息全部否官方文档

十一、消息抵达机器人的路径

消息进入机器人的路径 用户消息先进入群组或私聊会话,再经可见性判定过滤:受限模式只放行提及与斜杠命令,解除限制后放行全部消息,最终通过 webhook 回调或轮询拉取抵达开发者服务器。 用户发送消息 文本 / 图片 / 文件 会话 私聊 / 群组 可见性 判定 提及 / 命令 全部消息 Webhook 回调 公网地址 / 证书 轮询拉取 按间隔取回
图 1 消息抵达机器人的四段路径:发送、会话、可见性判定、接入通道;受限模式下仅提及与斜杠命令被放行,解除限制后放行全部消息(来源:官方文档,2026 年 10 月核对)

十二、权限与隐私的边界

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)