FoneClaw 連接 Telegram 機器人：BotFather 建立、配對與排障指南
教你用 BotFather 建立專用 Telegram bot，把私人聊天配對到 FoneClaw，確認第一個 Android 待辦結果，並處理 token、連線、webhook 衝突與移除後果。
- FoneClaw 連接 Telegram 機器人時，應先用官方 BotFather 建立專用 bot；bot token 只用來驗證機器人，不是你的 Telegram 帳號密碼或登入碼。
- 配對時要在 FoneClaw 儲存 token，然後開啟自己的 bot，在 10 分鐘內傳送 hello；第一個傳訊息的 Telegram 帳號會綁定這個私人聊天連線。
- 連線成功只代表訊息通道可用，不等於 Android 權限或任務核准都已完成；第一個測試可用沒有日期的待辦，然後到 FoneClaw 裡確認結果。
- 排障時要分清 token 錯誤、傳錯 bot、既有 bot 連線、Telegram 無法連線，以及輪詢程式或 webhook 衝突；移除 webhook 會停止原本端點收訊。
建立專用 Telegram bot
FoneClaw 連接 Telegram 機器人，意思是讓你用一個專用 Telegram bot 和 FoneClaw 進行私人聊天，再把你選定的請求交給 FoneClaw 處理。這和「用語音控制 Telegram App」不是同一件事；如果你的目標是操作 Telegram 裡的訊息或語音流程，可以另外看語音控制 Telegram：訊息管理更輕鬆。
建立 bot 時，請使用 Telegram 官方的 BotFather 教學。在 Telegram 裡找到官方 @BotFather，輸入 /newbot，依提示設定 bot 名稱和使用者名稱。完成後，BotFather 會給你一段 bot token。這段 token 是機器人的驗證金鑰，不是你的 Telegram 帳號密碼，也不是登入 Telegram 的驗證碼。
建議為 FoneClaw 建立一個專用 bot，不要拿已經接到其他服務的 bot 混用。這樣比較容易判斷訊息到底送到哪裡，也能降低輪詢程式（poller）或 webhook 衝突。token 請只貼到你信任的設定畫面，不要傳給其他人，也不要貼到群組或公開頻道。
配對你自己的私人帳號
拿到 BotFather token 之後，回到 FoneClaw 的 Telegram Connections 設定。找到 BotFather token 欄位，貼上 token，然後使用 Save bot token 儲存。儲存後，不要回去找 BotFather 聊天；你要開啟剛剛建立的自己的 bot，並在 10 分鐘內傳送 hello。如果配對視窗已過期，請在手機上點選 Connect this chat，這個英文按鈕是用來重新開啟聊天配對，然後在新的提示時間內向自己的 bot 傳送 hello 並等待確認。
這一步有兩個重點。第一，FoneClaw 的 Telegram bot 連線以私人聊天為準，不是群組或頻道流程。第二，第一個傳訊息給該 bot 的 Telegram 帳號會和這條連線綁定。所以請確認你是用自己的 Telegram 帳號、打開正確的 bot，送出字面上的 hello，並等到配對確認後再開始傳送任務。
如果你有多個 Telegram 帳號或多個 bot，建議先把 bot 名稱、頭像和用途整理清楚。常見錯誤是把 hello 傳給 BotFather，或傳給另一個同名相近的 bot。配對成功後，這個私人聊天可以成為你向 FoneClaw 提出簡短 Android 任務的入口，但 Android 權限和某些動作的核准仍會依 FoneClaw 當前設定處理。
確認第一個支援的 Android 結果
配對完成後，先測一個低風險、容易確認的任務。請不要一開始就要求複雜操作、敏感資料或跨多個 App 的流程。比較適合的第一句話是：「幫我建立待辦：整理保固文件，先不要排日期。」這句沒有日期、星期或相對時間，所以結果應該是未排程待辦，而不是行事曆事件。
傳出請求後，先看 FoneClaw 是否需要相關 Android 權限或核准。Telegram 負責把你的訊息送到 FoneClaw；真正的手機動作仍要依支援範圍、目前權限與核准設定完成。若有核准要求，請在 FoneClaw 裡查看內容與目的，再決定是否繼續。
完成後，到 FoneClaw 的待辦或對應結果位置檢查是否真的出現「整理保固文件」。如果你剛開始使用 FoneClaw，也可以先按FoneClaw Android 安裝設定：免費開始第一個 AI 智能體任務完成基礎設定；若你想更了解沒有日期的待辦如何保存，可看Android AI 待辦沒有日期：安全保存與改期。
依錯誤訊息排查連線問題
Telegram bot 連不上時，先看錯誤類型，而不是一直重貼 token。不同錯誤代表不同處理方式：
| 你看到的情況 | 可能原因 | 可以怎麼做 |
|---|---|---|
| token 被拒絕 | 貼錯、缺字、多空格，或不是 BotFather 給的 bot token | 回到 BotFather 複製完整 token，再貼到 BotFather token 欄位並重新儲存 |
| 等不到配對確認 | 沒有在 10 分鐘內傳 hello，或傳給 BotFather／錯誤 bot，或配對視窗已過期 | 在手機上點選 Connect this chat，依新的十分鐘配對提示打開自己的 bot，傳送 hello 並等待確認 |
| 提示 bot 已連接 | 該 bot 已有既有連線，或仍被其他服務使用 | 優先改用新的專用 bot；若要沿用原 bot，先確認現有連線是否仍需要保留 |
| Telegram 無法連線 | 網路、Telegram 服務或裝置連線狀態異常 | 先檢查網路與 Telegram 是否可正常收發訊息，再重試儲存或配對 |
| 輪詢程式或 webhook 衝突 | 同一個 bot 仍連到其他接收端點 | 優先建立新的專用 bot；只有在你確定要停用原服務時，才移除既有 webhook |
webhook 衝突特別要小心。移除 webhook 會停止原本端點接收該 bot 的訊息；如果那個 bot 正服務其他工具或團隊流程，直接移除會影響它們。最乾淨的做法通常是為 FoneClaw 建立新的專用 bot。
暫停、恢復或移除連線
連線建立後，你可以依需要暫停或恢復。Pause connection 會讓連線暫停；要重新使用時，請用 Resume connection 恢復。若你更新 bot token，既有配對和聊天記錄可以保留；但如果連線處於暫停狀態，仍需要先恢復後才適合繼續使用。
移除連線則是更重的動作。移除後，FoneClaw 會刪除已保存的 token、尚未處理的佇列請求與傳送紀錄；本機聊天歷史仍會保留。移除本機連線不等於撤銷 Telegram 端的 bot token。如果你懷疑 token 已外洩，請到 BotFather 撤銷或更換該 bot 的 token；只停止使用、移除本機連線或建立新 bot，都不會讓舊 token 自動失效。
連接 Telegram bot 不代表 FoneClaw 會全天候不受限制地完成所有動作。它是私人聊天入口，實際任務仍要符合 FoneClaw 支援範圍、目前 Android 權限與必要核准。你可以在FoneClaw 功能說明查看目前支援能力，並從FoneClaw 下載頁取得目前適合的 Android 安裝入口。設定好後，從一個能檢查結果的小任務開始，會比一次交代複雜流程更可靠。