Telegram
Anyy 使用 Bot Token 和 Bot API Long Polling 连接 Telegram。当前支持私聊、群聊、入站媒体、Pairing 与在线健康检查。
1. 在 Telegram 创建 Bot
打开 Telegram 官方 BotFather：
- 发送
/newbot； - 设置显示名称和 Username；
- 复制一次 Bot Token；
- 如果要加入群组，检查 BotFather 的 Privacy/Group 设置。
Bot Token 就是这个机器人的密码。得到它的人可以冒充机器人操作。
2. 在 Anyy 添加账号
进入 Dashboard → Channels → Add channel → Telegram。选择 Bot API Long Polling Profile，填写账号标识和 Token，检查访问策略后再启用。
也可以运行：
anyy setup channel telegram
设置流程会把 Token 保存成 Profile Secret 引用，并通过 Telegram getMe 验证远程 Bot 身份；验证成功后 Adapter 才会进入健康状态。
3. 设置谁可以发消息
默认策略：
| 会话类型 | 默认值 |
|---|---|
| 私聊 | pairing |
| 群聊 | mention |
私聊可选 open、allowlist、pairing、disabled；群聊可选 mention、allowlist、open、pairing、disabled。Allowlist 使用渠道设置/诊断页展示的 Telegram 数字用户或 Chat ID。
公开 Bot 可能被陌生人消耗模型配额或触发工具。扩大范围前，先确认审批和 Tool Policy。
4. Reload 并验证
anyy channel reload
anyy channel doctor telegram
然后私聊机器人。默认 Pairing 模式下，在 Dashboard → Channels 批准待处理 Sender；也可以使用：
anyy channel pairing list --channel telegram
anyy channel pairing approve --request REQUEST_ID
批准后重新发送一条消息，确认 Anyy 在同一个 Telegram 会话中回复。
群聊与 Mention
把 Bot 加入群组，默认 mention 策略下使用它的 @username。如果 Telegram Privacy 设置导致收不到目标消息，到 BotFather 调整，并按 Telegram 要求重新添加或 Reload。
当前 Adapter 不声明 Thread 支持，不要依赖 Telegram Topic 的独立路由。
媒体和长回复
Anyy 可以把受支持的入站 Telegram 媒体暂存到会话。过长的出站文字会按配置分段；下载和消息大小仍受 Telegram 与 Profile 上限约束。
常见问题
| 现象 | 检查项 |
|---|---|
| Token 被拒绝 | 从 BotFather 重新生成/复制，并替换保存的凭据 |
| Bot 一直 Backoff | 运行 anyy channel doctor telegram，检查 getMe 和 Bot API 网络 |
| 私聊只出现配对提示 | 批准请求后重新发一条消息 |
| 群消息被忽略 | Mention Bot，检查群策略/Allowlist 与 BotFather Privacy |
| 出现旧消息或重复 | 检查 Long Poll 健康并 Reload；Anyy 会持久保存 Update Offset |
通用渠道操作见 消息平台。