Telegram
个人私聊和群组都可以通过 Telegram Bot 接入。先在 BotFather 创建机器人，取得 Bot Token；准备加入群组时，同时检查机器人隐私设置和群组权限。
把 Bot 接进来
- 先让 Anyy 的主模型与 Gateway 正常运行。
- 打开 Dashboard 渠道 → 添加 → Telegram，默认采用 Bot API 长轮询，填写账号 ID 和
token。 - 保存后运行
anyy channel doctor telegram，查看身份和传输观测。
CLI 交互配置使用 anyy setup channel，在列表中选 Telegram。默认账号 ID 为 personal。Token 按 Profile 凭据保存；接入会使用 getMe 校验 Bot 身份。Token 是机器人的凭证，不要放进聊天或截图。
默认私聊需要配对
私聊默认 pairing，群聊默认 mention。当前设置目录允许：
| 位置 | 可选策略 |
|---|---|
| 私聊 | pairing、open、allowlist、disabled |
| 群聊 | mention、open、allowlist、disabled |
用 CLI 向导修改策略；Dashboard 凭据表单没有策略输入。Telegram 适配器虽能使用已有名单，当前公开向导没有名单条目编辑字段，不能把切换到 allowlist 当作已经配置好允许者。具体限制见消息平台。
先给 Bot 发一条私聊，再处理真实配对请求：
anyy channel pairing list --channel telegram
anyy channel pairing approve --request REQUEST_ID
批准后重新发送消息。配对授权没有把之前被拦截的消息自动重放为模型输入。
群组怎么验证
把 Bot 加入目标群，先用 @机器人用户名 测试默认 mention 策略。收不到群消息时，检查 BotFather 隐私模式、Bot 是否在群中及群策略。当前接入不声明 Telegram Topic/Thread 支持，不要依赖 Topic 隔离会话。
媒体、长文字与排查
受支持的入站媒体通过大小检查后暂存到当前会话；长文字按接入层长度上限分段。媒体上限与平台限制仍然适用。
anyy channel reload
anyy channel doctor telegram
- 身份失败：核对或轮换 BotFather Token。
- 私聊只收到配对提示：查看请求，批准后发送一条新消息。
- 群聊被忽略：检查提及、策略和 Telegram 权限。
- 旧消息或重复迹象：检查长轮询诊断；Anyy 会保存 update offset，不能把 Reload 当成重发历史的办法。