把 Telegram Bot 添加到群组后，很多群主都会遇到一个问题：输入 /start、/help 这类命令时，Bot 可以正常回复；但群成员正常聊天、发文字、发链接时，Bot 却完全没有反应。
这种情况大多数不是 Bot 程序坏了，也不是 Telegram 出现 Bug，而是 Telegram Bot 隐私模式 在起作用。这个设置也常被称为 Privacy Mode 或 Group Privacy。理解它之后，你就能判断 Bot 是只需要响应命令，还是必须读取普通群消息，才能实现自动回复、关键词提醒、入群审核、反垃圾广告等功能。
一、Telegram Bot 隐私模式是什么意思？
Telegram Bot 隐私模式，简单来说，就是控制 Bot 加入群组后能不能接收普通群消息的设置。
根据 Telegram Bot 功能文档，BotFather 中的 /setprivacy 可以设置 Bot 被添加到群组后能够接收哪些消息。默认情况下，Bot 通常不会像普通成员一样看到群里的所有聊天内容，这是 Telegram 为了保护群成员隐私而设计的机制。
开启隐私模式时，Bot 一般只能接收有限类型的消息，例如命令、回复它的消息、通过它发送的内容，以及部分服务消息。关闭隐私模式后，Bot 才能接收更多普通群消息。
所以，很多人说“Bot 加进群以后看不到群消息”，本质上通常是因为 Group Privacy 仍然处于开启状态。
二、为什么 Bot 在群里只能回复命令？
这是最常见的表现：你在群里发送 /help，Bot 有反应；但发送“你好”“测试一下”“这个链接可以发吗”，Bot 没有任何回复。
原因是命令属于明确发给 Bot 的消息，而普通聊天不一定会被推送给 Bot。Telegram 官方 Bot FAQ 对 Bot 能收到哪些消息有明确说明：关闭隐私模式的 Bot 和 Bot 管理员可以收到大多数消息，但通常不包括其他 Bot 发送的消息；开启隐私模式的 Bot 只能收到命令、回复、通过该 Bot 发送的消息等特定内容。可以参考 Telegram Bot FAQ。
因此，“命令能用，普通消息没反应”并不一定说明代码有问题。很多时候，Telegram 根本没有把普通聊天消息发送给这个 Bot。
三、隐私模式开启后 Bot 能看到哪些消息？
当 Group Privacy 开启时，Bot 通常可以收到这些内容：
用户在私聊中直接发给 Bot 的消息；
群里明确发给 Bot 的命令，例如 /start、/help；
带 Bot 用户名的命令，例如 /help@your_bot；
用户回复 Bot 消息时产生的内容；
通过这个 Bot 发送的 inline 内容或交互消息；
部分服务消息，例如成员加入、退出等。
这也是为什么很多 Bot 在群里“只会响应命令”，但不会处理普通聊天内容。
如果你的 Bot 只是用于查询、签到、投票、状态检查等命令型功能，保持隐私模式开启通常是合理的。这样 Bot 不需要读取所有群聊天，也能减少隐私风险。
四、隐私模式开启后 Bot 通常看不到什么？
隐私模式开启时，Bot 通常看不到群成员随手发送的普通文本、链接、图片说明、闲聊内容等。
例如，你希望 Bot 自动识别群里的广告链接，但 Group Privacy 仍然开启，那么 Bot 可能根本收不到这些广告消息，自然也无法判断、提醒或删除。
下面这些功能，通常需要 Bot 能读取普通群消息：
关键词自动回复；
广告链接检测；
敏感词提醒；
群聊内容统计；
新人发言监控；
自动转发用户问题给管理员；
根据普通消息触发客服或 AI 回复。
如果你的需求属于这些场景，就需要考虑关闭 Bot 的隐私模式。
五、Bot 看不到群消息时先检查什么？
在修改代码之前，建议先排查 Telegram 设置。很多“Bot 不工作”的问题，其实不是服务器或程序的问题，而是 BotFather 设置、群权限或测试方式不正确。
1. 检查 Group Privacy 是否开启
打开 Telegram，进入 @BotFather，发送：
/mybots
然后选择你的 Bot，进入 Bot Settings，查看 Group Privacy 或 Privacy Mode 的状态。不同 Telegram 客户端的显示文案可能略有不同，有些会显示“Privacy Mode”，有些会显示“Group Privacy”，以当前 App 界面为准。
2. 不要只用命令测试
只发送 /help 或 /start 不能判断 Bot 是否能读取普通群消息。因为命令本来就可能被 Bot 收到。
更准确的测试方式是：关闭隐私模式并重新添加 Bot 后，在群里发送一条普通文本，例如“测试普通消息”，然后查看 Bot 后台是否收到新的 message update。
3. 不要测试历史消息
关闭隐私模式不会让 Bot 自动收到过去的历史聊天记录。它只影响之后的新消息。
所以修改设置后，需要发送新的普通消息测试，而不是用之前已经发过的消息判断是否生效。
4. 检查程序是否过滤了消息
如果设置没问题，但 Bot 仍然没有反应，就要从开发侧继续排查：
webhook 是否配置正确；
long polling 是否还在运行；
服务器是否能正常访问；
代码是否只处理 command，忽略了普通 message；
allowed_updates 是否漏掉需要的更新类型；
日志里是否真的没有收到 update。
普通群主优先检查 BotFather 设置和群内权限；开发者则需要同时检查后台日志和消息处理逻辑。
六、如何通过 BotFather 关闭 Bot 隐私模式？
如果你的 Bot 确实需要读取群里的普通聊天内容，可以通过 BotFather 关闭 Group Privacy。
第一步：进入 BotFather
在 Telegram 搜索 @BotFather，进入官方 BotFather 对话窗口，然后发送：
/mybots
第二步：选择目标 Bot
在 Bot 列表中选择你要修改的 Bot，进入该 Bot 的设置页面。
第三步：找到 Group Privacy
进入 Bot Settings，找到类似下面的入口：
Group Privacy；
Privacy Mode；
群组隐私；
隐私模式。
不同语言和不同版本客户端显示可能不同，但含义基本一致。
第四步：选择 Turn off
进入 Group Privacy 后，选择 Turn off。这个操作表示关闭隐私模式，让 Bot 可以接收更多普通群消息。
也可以使用 BotFather 的 /setprivacy 命令进行设置。修改后，官方文档也提示可能需要一点时间生效。
第五步：移除并重新添加 Bot
这是很多新手最容易漏掉的一步。
建议操作流程是：
从群成员列表中移除 Bot；
等待片刻；
重新邀请 Bot 入群；
在群里发送一条新的普通消息；
查看 Bot 后台是否收到 update。
如果只在 BotFather 里点了 Turn off，但没有重新添加 Bot，可能会出现设置已经修改、群里却仍然没有效果的情况。
七、关闭隐私模式是否必须设置 Bot 为管理员？
不一定。
很多人会把“关闭隐私模式”和“设置群管理员”混在一起，但它们不是同一个功能。
Group Privacy 主要决定 Bot 能不能接收普通群消息；管理员权限主要决定 Bot 能不能执行管理动作。
例如，Bot 想读取普通文本并自动回复，重点是关闭隐私模式；但如果 Bot 要删除广告消息、禁言用户、踢人、管理邀请链接，就需要对应的管理员权限。
简单理解：
只做关键词回复：通常先关闭隐私模式即可；
要删除广告：需要关闭隐私模式 + 删除消息权限；
要禁言或踢人：需要限制成员或封禁成员权限；
要处理入群审核：需要相关管理权限；
只响应 /help、/start：通常不需要关闭隐私模式。
不建议一开始就给陌生 Bot 全部管理员权限。权限越高，风险越大，尤其是公开群和运营群更要谨慎。
八、关闭隐私模式前要注意哪些隐私风险？
关闭隐私模式会让 Bot 接触到更多群消息，所以它不仅是一个技术设置，也是一个隐私和信任问题。
Telegram 隐私政策中提到，Bot 添加到群组后可能以有消息访问权限或无消息访问权限两种模式运行；如果 Bot 有消息访问权限，它可以看到群组内发生的内容。更多说明可以查看 Telegram 隐私政策。
如果这是你自己开发的 Bot，建议明确说明：
Bot 会不会保存聊天内容；
数据会保存多久；
是否会上传到服务器；
谁可以查看后台数据；
是否用于统计、审核或 AI 分析。
如果是第三方 Bot，更要谨慎。不要随便把来源不明的 Bot 加入正式群，也不要直接给删除消息、封禁成员、管理群组等高权限。
更稳妥的做法是：先建立测试群，确认功能、权限和隐私说明都没问题，再放到正式群使用。
九、不同场景应该怎么选择隐私模式？
不是所有 Telegram Bot 都应该关闭隐私模式。是否关闭，取决于你的使用场景。
如果 Bot 只是用于命令查询，例如：
/help 查看说明；
/start 启动；
/poll 发起投票；
/check 查询状态；
/sign 签到；
这类 Bot 通常可以保持隐私模式开启。用户通过命令主动调用 Bot，Bot 不需要读取所有普通聊天。
如果 Bot 用于群管理或自动处理普通消息，例如：
自动删除广告链接；
关键词自动回复；
检测敏感词；
统计群活跃度；
新人发言提醒；
记录用户问题并转发给管理员；
这类 Bot 通常需要关闭 Group Privacy，否则它可能连普通消息都收不到。
比较推荐的上线流程是：
先在测试群添加 Bot；
测试 /start、/help 等命令；
关闭 Group Privacy；
移除并重新添加 Bot；
发送普通文本、链接和图片说明测试；
查看后台日志是否收到 update；
确认不会误删、误回复后，再放进正式群。
十、常见问题 FAQ
Telegram Bot 隐私模式是什么意思？
Telegram Bot 隐私模式，也叫 Privacy Mode 或 Group Privacy，主要控制 Bot 加入群组后能接收哪些消息。开启时，Bot 通常只能看到命令、回复等有限内容；关闭后，Bot 可以接收更多普通群消息。
为什么 Bot 在群里只能回复命令？
因为命令属于明确发给 Bot 的消息，而普通聊天不一定会发送给 Bot。如果 Group Privacy 仍然开启，就容易出现“命令能用，普通消息没反应”的情况。
Telegram Bot 看不到普通群消息怎么办？
先到 @BotFather 检查 Group Privacy 是否开启。如果 Bot 确实需要读取普通消息，可以关闭 Group Privacy，然后把 Bot 从群里移除并重新添加，再发送新的普通消息测试。
如何在 BotFather 关闭 Group Privacy？
打开 @BotFather，发送 /mybots，选择目标 Bot，进入 Bot Settings，找到 Group Privacy，然后选择 Turn off。也可以根据当前版本使用 /setprivacy 进行设置。
关闭隐私模式后为什么还是不生效？
常见原因包括：没有重新添加 Bot、测试的是历史消息、webhook 或 long polling 配置异常、allowed_updates 设置不完整，或者代码只处理命令而过滤了普通 message。
Bot 必须是群管理员才能读取消息吗？
不一定。读取普通群消息和管理群成员不是同一件事。关闭 Group Privacy 主要影响消息接收；管理员权限主要用于删除消息、禁言、踢人、管理邀请链接等操作。
Telegram Bot 能读取历史消息吗？
不能。关闭隐私模式不会让 Bot 自动收到过去的历史聊天记录。它只影响修改设置之后的新消息。
关闭 Bot 隐私模式会不会泄露群成员聊天内容？
风险会增加。因为 Bot 如果能访问群消息，开发者理论上可能处理或保存这些内容。群主最好只给可信 Bot 开放消息访问，并在群规则中说明 Bot 的用途。
Telegram Bot 能看到其他 Bot 发的消息吗？
通常不能。Telegram 官方 Bot FAQ 说明，Bot 不会看到其他 Bot 发送的消息，这是为了避免 Bot 之间形成循环响应。
