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 當成重發歷史的辦法。