群组管理¶
CNBot 可以帮助群主和管理员处理日常群管、违规拦截、自动回复和群内秩序维护。本文从使用者视角说明：你可以在哪里开启功能、指令怎么用、触发后群里会发生什么。
添加 CNBot 到群组¶
- 打开 CNBot 的 Telegram 资料页。
- 点击「添加到群组或频道」。
- 选择要管理的群组。
- 按 Telegram 提示将 CNBot 添加为管理员。
添加完成后，打开 CNBot 面板的「管理」页，群会自动出现在列表里；如果你当时正停留在面板上，切出去再切回来即可看到，无需手动刷新。
从 CNBot 私聊欢迎消息、Mini App 管理页或右下角添加菜单进入时，都会使用同一套 Telegram 添加流程。系统会预选日常群管所需的安全权限，但不会默认勾选「添加新的管理员」和「保持匿名」；您仍可在 Telegram 确认页里按实际需要调整。
权限要求¶
建议至少授予 CNBot 以下权限：
| 权限 | 建议 | 用途 |
|---|---|---|
| 删除消息 | 必须 | 删除违规消息、清理指令消息、删除退群提示、处理刷屏消息。 |
| 封禁用户 | 必须 | 执行封禁、踢出、禁言、自动处罚、退群自动封禁。 |
| 置顶消息 | 可选 | 使用 /pin 和 /unpin 时需要。 |
| 邀请用户 | 可选 | 基础群管不需要，部分邀请类功能可能需要。 |
如果某个功能没有生效，通常先检查 CNBot 是否仍是管理员，以及对应权限是否打开。
面板里看不到群？¶
「管理」列表只展示你担任管理员或群主的群组。如果某个群没有出现，按下表排查：
| 情况 | 解决办法 |
|---|---|
| 你在该群只是普通成员 | 只有群管理员和群主能在面板看到群，请先让群主为你添加管理员身份。 |
| CNBot 不在群里（从未添加或已被移出） | 重新把 CNBot 添加进群。 |
| 刚添加机器人 / 你刚被设为管理员 | 稍等片刻，切出面板再切回来，列表会自动刷新；一般几秒到几分钟内生效。 |
| 大群开启了「隐藏成员列表」，你是匿名管理员，且机器人还不是管理员 | 这是 Telegram 的查询限制：先把 CNBot 设为管理员，群就会正常出现。 |
能看到群，但功能是锁着的？
说明 CNBot 还不是这个群的管理员。进入该群管理页时顶部会出现提示条；按上方权限说明把机器人设为管理员后即自动解锁，无需其他操作。
打开群组设置¶
你可以用以下方式进入群组设置：
- 在群里发送
/config或/管理 - 打开 CNBot 面板，进入「管理」，选择对应群组
- 在群组设置里打开「群组管理功能」总开关
大部分自动群管能力都受「群组管理功能」总开关控制。关闭后，相关自动拦截和消息限制不会执行；面板会隐藏下方的「群组管理功能」设置入口，并在总开关下方显示启用说明。
开启总开关后，启用说明会消失，「群组管理功能」设置入口和原有说明会恢复。CNBot 面板「管理」主页里该群的副标题也会显示 「群组 · 已启用群组管理功能」；关闭总开关后只显示「群组」。频道则始终显示「频道」。
群管理首页的功能按分区排列，方便查找：群组管理功能（总开关、群管设置、AI 智能聊天、群组娱乐）→ 链接的频道 → 自动化与消息（关键词回复、定时任务、消息模板）→ 安全与应急（指令列表、本群拦截日志、紧急模式）→ 签到与积分（签到系统、积分记录）。
关于 /config 消息里的按钮
/config 在群里发出的设置消息带有内联按钮。为防止普通成员误操作，这些按钮只有当前群的管理员才能点击生效（任意管理员都可以，不限于最初发指令的人）；非管理员点击会收到「仅群管理员可操作」的提示。指向面板 / 打开链接的按钮不受此限制。
管理指令怎么指定用户¶
/ban、/mute、/warn 等指令支持三种目标定位方式：
| 方式 | 示例 | 建议 |
|---|---|---|
| 回复目标消息 | 回复某人的消息后发送 /mute 1h |
最准确，推荐优先使用。 |
| 使用用户 ID | /ban 123456789 |
适合已知用户 ID 的场景。 |
| 使用 @username | /warn @someone |
用户隐藏用户名或改名时可能无法定位。 |
如果要写原因，可以在指令后继续输入文字，例如 /mute 1h 刷屏。机器人反馈里会显示被操作用户和操作管理员的昵称，并提供可点击的用户链接。
手动群管指令¶
只有群管理员可以使用以下群管指令，普通成员发送会被拒绝。
封禁、解封与踢出¶
| 指令 | 作用 |
|---|---|
/ban |
永久封禁目标用户，并将其移出群组。被封禁用户无法通过普通邀请链接重新加入。 |
/dban |
永久封禁目标用户，并删除被回复的那条目标消息。 |
/unban |
解除封禁，允许目标用户之后重新加入群组。 |
/kick 或 /踢 |
将目标用户踢出群组，但不保留封禁状态；对方之后仍可重新加入。 |
/dkick |
踢出目标用户，并删除被回复的那条目标消息。 |
/ban 和 /kick 的区别很重要：/ban 是封禁，/kick 是踢出。只想让用户离开一次时，用 /kick；不希望对方再加入时，用 /ban。
禁言与解禁¶
| 指令 | 作用 |
|---|---|
/mute [时长] 或 /禁言 [时长] |
禁言目标用户。 |
/dmute [时长] |
禁言目标用户，并删除被回复的那条目标消息。 |
/unmute 或 /解禁 |
解除目标用户的禁言。 |
禁言时长支持这些写法：
30s：30 秒5min：5 分钟12hr：12 小时7d：7 天2wk：2 周1mo：1 个月1yr：1 年1mo20d3h47m30s：组合时长- 不写时长或写
0：永久禁言
警告系统¶
| 指令 | 作用 |
|---|---|
/warn 或 /警告 |
给目标用户增加 1 次警告。 |
/dwarn |
增加警告，并删除被回复的那条目标消息。 |
当前规则：
- 每个用户在同一群内累计达到「警告次数阈值」后，会自动禁言 24 小时。
- 阈值默认为 3 次，可在小程序「群组管理功能 → 警告」里改成 2/3/4/5/6/8/10 次，修改后立即生效。
- 自动禁言触发后，警告次数会清零。
- 警告反馈下方有
-1、重置、+1和「好」按钮，管理员可以直接调整警告次数。
消息处理¶
| 指令 | 作用 |
|---|---|
/d 或 /del |
删除被回复的那条消息，并尝试删除你的 /d 指令消息。 |
/pin 或 /置顶 |
置顶被回复的消息。 |
/unpin 或 /取消置顶 |
取消置顶。回复某条置顶消息时取消该条；不回复时取消当前置顶。 |
/clean_deleted 或 /清除注销 |
清理群内已注销账号和已经离群用户留下的本地记录。 |
/modlog |
查看最近群管记录。支持按类型或用户筛选。 |
/modlog 示例：
/modlog：查看最近记录/modlog warn：只看警告记录/modlog spam：只看自动拦截/刷屏记录/modlog @someone：查看某个用户的记录/modlog summary @someone：查看某个用户的记录概览
群管反馈按钮¶
执行 /ban、/mute、/warn 等操作后，CNBot 会发送一条结果反馈。常见按钮包括：
| 按钮 | 作用 |
|---|---|
| 取消封禁 | 撤销刚才的封禁，让用户可以重新加入。 |
| 取消禁言 / 解除封禁 | 恢复目标用户发言或解除封禁。 |
| -1 / 重置 / +1 | 调整警告次数。 |
| 好 / 好的 | 删除这条机器人反馈消息，让群里更干净。 |
在「群组操作消息」里可以设置这些反馈消息是否自动删除：
| 选项 | 效果 |
|---|---|
| 关闭 | 反馈消息会保留，管理员可以手动点「好」。 |
| 立即删除 | 反馈发送后立即删除。 |
| 10 秒 / 30 秒 / 1 分钟 / 5 分钟 | 反馈消息在指定时间后自动删除。 |
骚扰消息拦截¶
在「群组管理功能」→「骚扰消息拦截」中可以开启：
| 功能 | 触发后会发生什么 |
|---|---|
| 拦截广告链接 | 普通成员发送 t.me、外部网址等广告链接时，CNBot 会删除消息并按设置禁言。 |
| 拦截敏感词 | 普通成员命中敏感词词库时，CNBot 会删除消息并按设置禁言。 |
| 敏感词词库 | 管理本群要拦截的词，多个词用逗号分隔。 |
| 违规禁言时长 | 设置自动处罚时长，支持 1/5/10/30 分钟、1/6/12 小时、1/3/7 天和永久。 |
说明：
- 管理员发言默认豁免，不会被广告链接或敏感词自动处罚。
- 自动处罚提示会显示违规用户、违规原因和处罚结果。
- 提示底部有「解除封禁」和「好」按钮，管理员可直接处理。
消息发送限制¶
在「群组管理功能」→「消息发送限制」中可以开启：
| 功能 | 说明 |
|---|---|
| 拦截频道身份发言 | 成员用频道身份发言，或转发频道内容到群里时，CNBot 会自动删除。适合处理匿名引流和频道号刷屏。 |
| 删除指令消息 | 群内 /ban、/mute、/help 等指令被处理后，CNBot 会尝试删除用户发出的原始指令消息。 |
| 发言频率限制 | 普通成员短时间发送过多消息时，只删除超出的刷屏消息；不会禁言。 |
发言频率限制档位：
| 档位 | 规则 |
|---|---|
| 关闭 | 不限制发言频率。 |
| 宽松 | 10 秒内最多 10 条，第 11 条开始删除。 |
| 标准 | 10 秒内最多 6 条，第 7 条开始删除。 |
| 严格 | 5 秒内最多 3 条，第 4 条开始删除。 |
管理员和机器人账号不受发言频率限制影响。
群成员白名单¶
在「群组管理功能 → 群组成员白名单」里可以添加白名单成员。白名单内的成员会豁免以下自动拦截：
- 拦截广告链接
- 拦截敏感词
- 发言频率限制
填写方式：
- 一行一个，或用逗号、空格、顿号分隔都可以。
- 推荐填数字用户 ID（最稳定，对方改名也不受影响）。
- 也可以填
@用户名或用户名（对方改名或隐藏用户名后可能失效）。 - 大小写不敏感。
白名单只影响自动拦截，不影响管理员手动执行的 /ban、/mute 等指令。
限制成员使用指令¶
在「群组管理功能 → 限制群成员使用指令」里开启后，普通成员只能使用你允许的指令，其它指令会被拦截。
| 设置 | 说明 |
|---|---|
| 启用 | 打开后开始限制普通成员可用的指令。 |
| 允许使用的指令 | 普通成员仍可使用的指令白名单，一行一个或用逗号分隔，填不填 / 都可以。 |
说明：
- 管理员不受限制，可使用全部指令。
- 普通成员发送不在白名单里的指令时，CNBot 不会响应；若同时开启了「删除指令消息」，原始指令消息会被删除。
- 适合只想让成员用
/checkin、/points等少数指令、屏蔽其它指令的场景。
退群成员处理¶
在「退出群组成员处理」中可以开启：
| 功能 | 说明 |
|---|---|
| 自动封禁 | 普通成员主动退群后，CNBot 会自动永久封禁，防止对方反复进群。 |
| 删除退群提示 | 自动删除 Telegram 生成的“某某离开了群组”提示消息。 |
说明：
- 管理员手动踢出用户不会触发“退群自动封禁”。
- 机器人账号和系统账号不会被误处理。
- 这两个功能需要 CNBot 拥有封禁成员和删除消息权限。
新成员权限限制¶
在「群组管理功能 → 新成员权限限制」里开启后，新成员加入群组后会被临时限制发送权限，到期后由 Telegram 自动恢复群默认权限。
| 设置 | 说明 |
|---|---|
| 启用 | 打开后对新加入的普通成员生效。 |
| 限制时长 | 限制持续多久（例如 5 分钟、10 分钟）；到期自动恢复。 |
| 临时允许新人发送 | 这几项是「允许」开关：开 = 限制期内允许发送该类型；关 = 限制期内禁止。包含发送文字消息、发送媒体消息、发送投票、发送贴纸和 GIF、创建链接预览。 |
使用要点：
- 这些开关是「允许」，不是「禁止」。全开 = 新人不受任何限制；想限制就把对应项关掉。
- 例如只想让新人在前 10 分钟内不能发文字，就把「发送文字消息」关掉、限制时长设为 10 分钟。
- 全部关闭 = 新人在限制时长内无法发送任何消息。
- 只对普通新成员生效，管理员和机器人不受影响。
- 需要 CNBot 拥有「封禁 / 限制成员」权限，否则限制无法下发。
签到与积分（本群）¶
在群管理首页的「签到与积分」分区，可以按群控制签到与积分体系：
- 签到系统：开启后，群成员可以在群里发送签到指令，为本群积累积分；关闭则本群签到停用。
- 启用积分记录：仅在签到系统开启后显示。关闭后，本群的签到、积分查询与排行榜一并停用（只影响本群，其他群和面板「积分」页不受影响）。
积分的玩法与指令详见积分系统。
关键词自动回复¶
进入 CNBot 面板 → 管理 → 选择群组 → 关键词回复，可以为当前群组创建高级自动回复规则。规则由“触发条件”“回复内容”“匹配选项”和“执行动作”组成，不再局限于单个文字关键词。
触发条件¶
一条规则可以设置以下任意条件：
- 文本关键词：支持精确文本、包含文本和正则表达式。
- 文件名：按成员发送文件的名称或说明匹配。
- 贴纸 Emoji / 贴纸包名称：按贴纸表情或整套贴纸识别。
- 发送者：支持文字、用户名、数字 ID，或
/.../包裹的正则表达式。 - 转发来源：识别转发消息的来源名称或频道。
开启“独立匹配”时，任意一个已填写条件命中即可触发；关闭时，已填写的条件需要同时满足。管理员可进一步选择忽略管理员、忽略大小写、忽略简繁差异，以及是否匹配编辑后的消息。
回复内容与消息模板¶
- 没有选择模板时，可直接配置文字回复或图片回复。
- 可以按顺序选择多个群组消息模板，并设置每次回复数量。
- 支持随机回复；关闭随机回复时按选择顺序发送。
- 支持跨消息回复，让多条模板连续发送到同一触发上下文。
- 模板选择器内可搜索、新建或编辑模板；从模板页返回时会保留规则草稿和滚动位置。
冷却、清理和处罚动作¶
- 冷却时间：防止相同规则在短时间内连续刷屏。
- 删除触发消息：命中后按设置延迟删除成员原消息。
- 删除机器人回复：机器人回复后按设置自动撤回。
- 警告：命中后增加成员警告数，并沿用本群警告阈值规则。
- 处罚方式：可配置禁言或封禁；频道身份发送的消息无法执行成员警告/禁言，会按 Telegram 权限边界处理。
- 测试当前规则：保存前输入一条示例消息检查匹配结果。
每条规则可以单独启用/停用，并记录触发次数。列表支持搜索、筛选、刷新和整卡进入编辑；开启或关闭规则时不会整页闪烁刷新。
数量上限：
- 免费群组最多可创建 50 条关键词规则。
- 开通 VIP 后上限提升到 300 条。
- 关键词页面顶部会显示「已用 X / 上限」。
匹配顺序：
- 本群规则优先于全局规则。
- 带有非空文本关键词的精确匹配优先，其余规则按管理员保存的执行顺序和规则 ID 稳定执行。
- 首个命中的可执行规则会处理本次消息；已失效且没有任何动作的规则不会被重新启用来遮挡后续规则。
- 成员发送
/开头的指令时，不会触发关键词自动回复。
高级规则会随群配置备份一同导出和恢复，包括发送者、转发来源、消息模板顺序、冷却、删除触发消息、警告、禁言和封禁等字段。导入时会校验模板引用，避免把其它群或已删除模板错误绑定进来。
更多管理员指令（群规、举报、批量清理、权限锁等）见 群安全与管理指令。
欢迎消息¶
在群组设置中可以开启「入群欢迎」。开启后，新成员加入群组时，CNBot 会发送欢迎语。
欢迎消息有两种发送方式：
- 欢迎文本：直接填写一段支持 Markdown 的欢迎语。
- 消息模板：选择一条群组消息模板，发送图文、按钮或其他已配置内容；选择模板后不再发送上方欢迎文本。
模板列表右侧提供新建与编辑入口，不需要先离开当前页面。较长的模板名称会在列表里自动省略，完整内容仍可进入编辑页查看。
欢迎语可使用占位符：
| 占位符 | 含义 |
|---|---|
{username} |
新成员昵称 |
{title} |
群组名称 |
{userid} |
新成员 Telegram ID |
CNBot+ 群组还可以设置欢迎消息自动删除时间，让欢迎消息在发送一段时间后自动清理。
入群验证¶
在「群组管理功能 → 入群欢迎与验证 → 入群验证」里可以让新成员先完成一项验证,才能正式在群里发言;验证失败或超时会被自动踢出群组,有效拦截机器人和广告号。
8 种验证类型¶
| 类型 | 怎么验 |
|---|---|
| 关闭 | 不做验证,新成员直接可以发言。 |
| 网页验证 | 群里发挑战卡片含「🔐 点击完成验证」按钮,跳到一个网页,用户点「我不是机器人」按钮即可通过。最简洁的人机识别。 |
| 算术验证 | 群里发一道两位数算术题(加减乘),4 个选项 1 个正确。点对的通过。 |
| 订阅频道验证 | 要求新成员先订阅一个指定频道,再点「✅ 我已订阅」按钮完成验证。⚠️ 机器人必须是该频道的管理员,否则 Telegram API 会拒绝查询订阅状态,验证会自动放行。 |
| 发送贴纸验证 | 要求新成员从指定 Telegram 贴纸包里发任意一张贴纸。设置目标贴纸包名(t.me/addstickers/XXX 中的 XXX)。 |
| 星币验证 | 要求新成员通过 Telegram Stars 支付管理员设置的验证费用。验证已结束或超时后不会继续扣款。 |
| 半自动入群验证 | 不向用户出题，由群管理员在审核消息中选择通过、拒绝或拒绝并举报。 |
| 拒绝新成员加入 | 完全关闭群组入新成员通道,任何加群请求都被立即踢出。 |
验证期间会发生什么¶
- 新成员入群后立即被限制发言(只有发送贴纸验证时可以发贴纸)
- 群里弹出挑战卡片(显示题目/按钮/超时时间);卡片底部会写明需在多久内完成以及未通过会被封禁多久——例如「请在 60 秒内完成验证,以免被封禁 24 小时」。默认封禁时长设为「永久」时,会显示「被永久封禁」。
- 用户在「超时时间」内完成 = 通过 + 自动恢复发言;失败或超时 = 自动踢/封禁
- 管理员可就地裁决:挑战卡片下方带
✅ 通过/🚫 拒绝/🚫 拒绝并举报三个按钮,只有本群管理员能点(非管理员点会提示)。点「通过」= 放行;点「拒绝」= 按被拒绝的用户封禁时长封;点「拒绝并举报」= 按骚扰用户封禁时长封。裁决结果会直接改写原挑战消息,不再另发一条。 - 失败 / 超时后的结果:验证结果会尽量直接改写原挑战消息，避免重复发送多条结果。管理员仍可按消息中的操作入口解除封禁或举报骚扰。
通用设置项(无论选哪种验证类型都生效)¶
| 设置 | 说明 |
|---|---|
| 超时时间 | 用户多久没完成 = 算超时(60 / 120 / 180 / 300 / 600 秒)。 |
| 自动删除验证消息 | 验证结束后(通过/失败/超时),挑战消息多久从群里删,保持群组干净。「关闭」= 不删。 |
| 默认封禁时长 | 失败/超时的用户被封禁多久。「永久」表示永远进不来,「1 小时 / 24 小时 / 7 天」等可选。 |
| 骚扰用户封禁时长 | 被启发式判定为骚扰用户时的封禁时长(可选「使用默认时长」回落到上面)。 |
| 被拒绝的用户封禁时长 | 「拒绝新成员加入」模式下使用的封禁时长。 |
| 最大尝试验证次数 | 单次验证内连续答错多少次 = 立即踢出(算术验证用)。「不限制」= 仅靠超时机制。 |
| 验证消息文本 | 自定义提示文字,会追加到挑战消息底部(留空则用默认)。 |
Premium / 骚扰用户自动判定(放在所有验证类型之前)¶
| 开关 | 行为 |
|---|---|
| 自动通过 Premium 用户入群 | Telegram Premium 用户直接放行,不发挑战。即使群里设了「拒绝所有新成员」也能进。Premium 用户基本不是机器人,推荐开启。 |
| 自动拒绝非 Premium 用户入群 | 非 Premium 用户立即被踢/封。最强反垃圾(适合付费会员群)。 |
| 自动拒绝系统判断为骚扰的用户入群 | 启发式判定:新账号无用户名 / 昵称纯数字 / 完全无身份信息等 = 立即踢/封。 |
「通过对话加入请求验证」开关¶
如果您的群组是「需要管理员审核」的(私有群组或开了「申请加入需审核」的邀请链接),那:
- 开关关闭:走 Telegram 默认审核流程,需要管理员手动同意。
入群验证记录¶
群组管理界面的入群验证入口，支持查看最近 100 条验证记录。
在记录面板里可以直观地看到：
- 用户标识：会显示用户的昵称，如果用户配置了 Telegram 用户名，则会在下方显示 @用户名。如果未配置，则会明确显示 (此账号无用户名)，同时附带用户数字 ID，方便管理员精准定位该用户。
- 验证方式：网页、贴纸、算术等。
- 验证结果：通过、失败、超时、系统自动拒绝等详细原因。
- 时间：精确到秒的处理时间。
- 开关开启:CNBot 接管审核 — 新成员申请加入时,bot 会在私聊里给他发挑战(挑战类型跟群里入群的相同),完成 = 自动同意进群,失败 = 自动拒绝。
- ⚠️ 用户必须之前和机器人私聊过(发过任何消息),否则机器人无法私信他,会自动拒绝。
实战推荐配置¶
| 场景 | 推荐 |
|---|---|
| 大型公开群,主要挡机器人 | 验证类型 = 算术验证,超时 60 秒,默认封禁时长 = 永久 |
| 小型熟人群,减少摩擦 | 验证类型 = 网页验证 + 开「自动通过 Premium 用户」 |
| 付费会员群 | 开「自动拒绝非 Premium 用户」(无视验证类型,非会员直接踢) |
| 需审核的群组(私有 / 申请审核) | 任意验证类型 + 开「通过对话加入请求验证」 → bot 在私聊审核 |
| 暂时关闭新成员入口 | 验证类型 = 拒绝新成员加入 |
签到、娱乐与 AI 开关¶
群组管理员可以在面板里单独控制：
| 功能 | 开启后 |
|---|---|
| 签到功能 | 群成员可以发送「签到」、/checkin、/points、/top 使用积分功能。 |
| 群组娱乐功能 | 群成员可以使用 /slap、/hug、/who、/jrp、/tg、/jt 等互动指令。 |
| AI 聊天 | 群成员可以用 /chat、回复机器人或 @机器人 触发 AI 对话。 |
如果某个指令提示“本群未开启”，请到面板检查对应开关。
定时任务（定时改群权限 / 定时发消息）¶
在「群组管理功能 → 定时任务」里可以创建到点自动执行的任务，常用于定时禁言 / 解禁全群，或定时发布提示消息。
每个任务可以设置：
| 设置 | 说明 |
|---|---|
| 运行时间 | 每天几点执行。 |
| 运行日期 | 周几执行（可多选）。 |
| 模式 | 决定到点后怎么处理群权限，见下表。 |
| 提示消息模板 | 可选，到点时按顺序发送最多 6 条模板消息。 |
两种模式：
| 模式 | 到点后会发生什么 |
|---|---|
| 系统模式 | 直接修改整个群的发送权限（例如到点把全群禁言，或到点解禁）。 |
| CNBot 模式 | 在限制时段内，按你设置的消息类型删除群里对应类型的消息（例如只允许文字、删除媒体）。 |
提示消息支持文本、语音、贴纸、转发（拷贝）消息，以及解析模式、链接预览、彩色 URL 按钮、静音、内容保护、置顶等选项；语音 / 贴纸等媒体的 File ID，可把该消息转发给 CNBot 再回复 /id 获取。在群组中使用 /id 时，查询结果会优先私发给操作人；首次使用前需要先打开机器人私聊并点击 Start。每条消息都能先点「发送预览」发到你与机器人的私信确认效果。这些字段的完整说明见 群组消息模板。
其它说明：
- 管理员和白名单成员不受 CNBot 模式的消息删除影响。
- 任务列表里有「立即执行」按钮，可随时手动测试一次，并显示最近执行结果。
- 若 CNBot 权限不足或执行失败，会私信任务创建者（同类问题 24 小时内只提醒一次）；连续失败 3 次会自动暂停该任务，处理后可重新开启。
- 部分高级能力需要订阅后使用，面板会有对应标注。
发送后自动撤回¶
在任务编辑页 → 高级设置 的最底部，可以为该任务的提示消息设置「自动撤回发送的消息」倒计时，可选 30 秒 / 1 分钟 / 5 分钟 / 10 分钟 / 30 分钟 / 1 小时 / 6 小时 / 1 天，默认「关闭」。
- 开启后，该任务每次发送的每条模板消息，都会在到点倒计时结束后自动从群里删除。
- 倒计时从消息发出那一刻开始算，每条消息独立排队，互不影响。
- 与「删除上一轮发送的消息」「取消置顶上一轮」完全独立可叠加：那两项是下一轮发送前清理上一轮，自动撤回是消息发出立即排倒计时。
- 同时勾选「置顶发送的消息」时，置顶状态会随消息被删除而消失，符合预期。
适合定时发活动公告、限时通知、清场提醒、广告等到点要自动清理掉的场景，让群里不堆冗余消息。
联防联控¶
联防联控可以把多个群组用同一个「联防码」组成一队，一个群处理某个用户时，自动同步到队里的其它群。
在「群组管理功能 → 联防联控解决方案」里设置：
| 设置 | 说明 |
|---|---|
| 启用 | 打开本群的联防同步。 |
| 联防码 | 同一个联防码的群组属于同一队；在你管理的多个群填相同的码即可组队。 |
| 同步本群封禁 | 本群发生封禁 / 解封 / 禁言 / 警告时，推送给同队的其它群。 |
| 接收联防封禁 | 接收同队其它群推送过来的处理，在本群一并执行。 |
说明：
- 目前同步的操作包括封禁、解封、禁言和警告。
- 只在你同时管理、都填了相同联防码、并各自开启同步的群之间生效。
- 适合社区有多个关联群、想统一拉黑同一批捣乱用户的场景。
操作 ID 与申诉¶
当封禁 / 禁言通过联防联控同步到了其它群时，CNBot 会为这次处理生成一个 操作 ID（8 位数字编号）：
- 群里的处理通知末尾会带上「🆔 操作 ID：XXXXXXXX」，管理员可凭它追溯。
- 同一个编号会写进来源群和所有被同步群的拦截日志（见下文「拦截日志」），整条联防链路可以按编号对账。
- 如果被处理的用户之前和机器人私聊过（发过任意消息），还会收到一条私信，告知群名、操作 ID 和官方申诉群链接（由站点管理员配置）；没和机器人私聊过的用户收不到私信，但群里通知仍带编号。
- 只有联防跨群处理才生成操作 ID。只在本群生效的普通
/ban、/mute、/kick以及广告 / 敏感词自动处罚不发编号、不私信——本群管理员本地即可解封。
被误处理的用户可凭操作 ID 到官方申诉群申诉，无需回到原群。
用 /op 一键解除¶
拿到操作 ID 后，管理员可以在群里直接解除这次处理：
- 哪里能用：来源群和任何被联防同步过的群——只要这次处理在本群留有记录，本群管理员就能解。无关的群里无法使用。
- 解除范围：先解除本群的封禁 / 禁言，再按本群的联防设置同步解除其它联防群（本群没开「推送封禁」时只解本群）。
- 解除动作本身也会记入拦截日志，方便追责；同一位管理员 10 秒内只能执行一次解除。
- 「踢出」类操作无需解除（被踢用户本就可以重新加群）。
- 跨联防、找不到对应群时，站点管理员也可以在后台凭编号解除（作用于来源群并全网同步）。
绑定频道的帖子¶
当频道绑定了讨论群后，频道发的帖子会自动转发到讨论群。在「群组管理功能 → 绑定频道的帖子」里可以处理这些自动转发的帖子：
群组管理首页会显示「链接的频道」
如果本群是某个频道的讨论群，群组管理首页会出现一张 「链接的频道」 卡片，显示该频道的名称 / @用户名；在面板里点击可直接跳到该频道的设置页，方便在群和频道之间来回管理。
| 设置 | 说明 |
|---|---|
| 自动取消置顶 | Telegram 默认会把转发到讨论群的频道帖子置顶，开启后 CNBot 会自动取消置顶，保持群里整洁。 |
| 自动回复 | 在每条转发来的频道帖子下自动回复一条固定消息（例如引导大家到评论区讨论）。 |
| 同频气氛组（AI 点评） | 让 CNBot 以群成员的身份，对新帖子生成一到两句自然的 AI 点评，给评论区暖场。可选点评风格与态度倾向；开启后优先于上面的固定自动回复。详见 AI 助手 · 同频气氛组。 |
固定自动回复支持占位符：
| 占位符 | 含义 |
|---|---|
{title} |
讨论群名称 |
{channel} |
来源频道名称 |
{post_id} |
帖子消息 ID |
呼叫管理员¶
在「群组管理功能 → 呼叫管理员」里开启后，群成员遇到情况可以一键把管理员喊来。
- 触发方式：群成员发送
/admin、@admin，或你自定义的呼叫词（多个用英文逗号或换行分隔，命中其中任意一个即触发）。 - 触发后 CNBot 会在群里回一条「已通知管理员」的提示。
- 若开启「私信通知群组管理员」，还会私信每一位管理员，附上可跳转到呼叫消息的链接。
| 设置 | 说明 |
|---|---|
| 允许呼叫管理员 | 打开本功能。 |
| 私信通知群组管理员 | 除了群内提示，再私信每位管理员一份带跳转链接的通知。 |
| 自定义呼叫词 | 除 /admin、@admin 外自定义触发词；留空则只用内置的两个。 |
说明：
- 每群 60 秒内只处理一次呼叫，短时间内重复呼叫只会收到"稍候"提示，不会反复打扰管理员。
- 管理员如果从未和 CNBot 私聊过，Telegram 不允许机器人私信他（收不到私信属正常），但群内提示不受影响。
- 每位管理员可以在个人设置里关闭「接收呼叫管理员私信」，关闭后你管理的所有群的呼叫都不再私信你。
事件消息（退群 / 入群请求）¶
在「群组管理功能」里可以为几类成员事件配置自动消息：
| 事件 | 说明 | 可用占位符 |
|---|---|---|
| 退群消息 | 成员主动退出群组时，在群里发送一条你设置的消息。被封禁 / 被移出的成员不会触发。 | {username}、{title}、{userid} |
| 入群请求通知 | 用户提交加群申请后，CNBot 私信申请人，告知申请已收到、请等待审核。 | {username}、{title} |
说明：
- 退群消息只在成员自己退群时触发，管理员踢人不算。
- 入群请求通知只对开启了「申请加入」模式的群有意义；申请人若从未和机器人互动过，Telegram 不允许私信，会静默跳过。
- 新成员进群的欢迎消息请见上文「欢迎消息」一节。
拦截日志（面板）¶
面板 → 发现 → 拦截日志 汇总你管理的全部群的处理记录：
- 内容：广告链接 / 敏感词自动拦截，以及封禁、解封、禁言、警告等管理操作（不同类型有对应徽章）。
- 操作 ID：联防跨群处理的记录行带「🆔 编号」徽章——来源群和被同步群显示同一个编号，可直接在搜索框按编号查整条链路。
- 筛选与搜索：可按 今天 / 昨天 / 近 7 天 / 仅广告链接 / 仅敏感词 / 仅管理操作 筛选；搜索支持关键词、UID、用户名、操作 ID。
- 导出 CSV：机器人会把文件私信发给你（需先和机器人私聊过），表格含「操作ID」列；也可一键清空日志。
操作记录推送到频道¶
想给团队留一份可追溯的管理台账，可以在「群组管理功能」里给本群配置一个操作记录推送频道。
- 配置后，本群的每一条管理操作（封禁 / 解封 / 禁言 / 警告 / 踢出等）都会实时转发一份到该频道，内容含群名、操作、对象、详情和时间。操作 ID 请在上文「拦截日志」页或导出的 CSV 中查看。
- 频道填
@用户名或频道的-100数字 ID 都行；需要 CNBot 是该频道的管理员。 - 推送失败不会影响群内的正常管理，只是那条记录没推出去。
指令列表（按群启用/停用指令）¶
进入「群组管理功能」→「指令列表」，可以为本群单独关闭某些指令。关闭后，普通群成员在本群发送该指令时机器人不会响应（管理员专用指令在管理员手中仍然能用）。
使用方式：
- 列表会显示机器人在群里可用的全部指令；管理员专用的指令标注「(仅管理员)」。
- 每个指令右侧有一个开关：开 = 启用、关 = 停用。
- 修改后点底部「保存」生效。
说明：
- 本设置只影响本群，不会影响其它群或私聊。
- 如果开启了「消息发送限制 → 删除指令消息」，被关闭的指令对应的群成员消息会被自动删除。
- 此设置不会移除 Telegram 「/」菜单里的指令显示，只是机器人不再响应。
紧急模式¶
进入「群组管理功能」→「紧急模式」，应对群内突发的紧急情况。两种模式可单独开启，开启时机器人会在群里发一条提示告知该模式已启用。
| 模式 | 效果 |
|---|---|
| 静默模式 | 机器人仍处理群里的消息和事件，但停止向本群发送消息（包括欢迎语、关键词回复、违规提示等）。 |
| 离线模式 | 机器人完全停止处理本群任何事件（消息、新成员加入、群管拦截等），相当于这段时间机器人对本群"装睡"。 |
每种模式都可以选择持续时长（30 分钟到 1 天），到期自动解除。提醒消息里会显示到期时间。
使用建议：
- 群内有突发情况想让机器人安静一会儿（例如有事不想被自动拦截打扰）→ 用静默模式。
- 怀疑机器人误处理、或要让机器人完全停手一段时间 → 用离线模式。
- 「入群验证」等关键流程在静默模式下也会被停掉，可能导致新成员无法通过验证，请按需选择。
- 关闭紧急模式开关也会立刻恢复正常（不需要等到时长到期）。