FoneClaw Discord 連線失敗：配對、任務狀態與回傳排查
FoneClaw Discord 沒有回覆，先分清機器人連線、私訊配對、佇列、Android 權限與結果傳送。整理 Bot Token、Message Content Intent、十分鐘配對及 /retry 安全復原步驟。
- FoneClaw 的 Discord 入口是機器人文字私訊連線；先分清連線、請求接收、佇列、手機執行及結果傳送，不用麥克風或藍牙設定排查。
- 建立機器人並啟用 Message Content Intent，透過 OAuth2 安裝到伺服器，將 Bot Token 存入 FoneClaw，再於十分鐘內私訊 hello；第一個傳訊的 Discord 帳號會綁定。
- /status 可查看執行中與排隊數量；手機上的權限及核准仍要另行處理，連線成功不代表 Android 任務已完成。
- /retry 重新排入已保存結果的傳送，不是重跑手機操作；/stop 停止目前與排隊請求，但不撤銷已完成動作，重送前先查實際目的地。
先找出卡在連線、執行還是回傳
遇到 FoneClaw Discord 連線失敗，先不要重送原本的手機操作。這個入口是 Discord 機器人的文字私訊：訊息進入 FoneClaw、排入任務、執行支援動作，再把結果傳回。沒有看到回覆，可能卡在其中任何一段，不代表手機什麼都沒做。
| 看到的情況 | 先查哪一段 | 下一個檢查 |
|---|---|---|
| Token 無效或連線不可用 | 機器人連線 | Token、網路與 Message Content Intent |
| 存好設定，私訊卻未完成配對 | 私訊與帳號綁定 | 是否在期限內傳給正確機器人 |
| 顯示排隊或佇列已滿 | 請求接收與佇列 | 用 /status 查看執行中與排隊數量 |
| 手機顯示待核准或缺少權限 | Android 動作 | 到手機處理實際提示 |
| 手機已有結果，Discord 沒收到 | 結果傳送 | 查看已保存結果及 /retry 回應 |
先保留原請求文字、時間與目前狀態。這些資訊可以幫你辨認是哪一次任務，尤其是建立待辦、行事曆或其他會寫入的操作。Discord 通話、麥克風或耳機問題屬於另一條流程；若實際症狀是說話沒聲音，請看Discord 手機麥克風測試：Android 語音活動、藍牙耳機與悶聲排障。
核對機器人、Token 與訊息內容設定
先確認設定的是自己的 Discord 機器人，而不是一般帳號憑證。Discord 官方機器人入門說明 Developer Portal、Bot Token 與 OAuth2 安裝的基本用途。FoneClaw 的設定順序如下：
- 在 Discord Developer Portal 建立機器人。
- 啟用 Message Content Intent。
- 使用 OAuth2 安裝流程，把機器人加入伺服器。
- 複製該機器人的 Bot Token。
- 在 FoneClaw 的 Discord 連線設定貼上 Token 並保存。
- 接著完成私訊配對，不停在機器人已加入伺服器這一步。
Discord Gateway 與 Intents 說明將 Message Content 列為特權 Intent；FoneClaw 的設定明確要求啟用它。若出現 Message Content Intent 錯誤，先在正確的機器人設定啟用，再使用畫面上的重試。不要為了排錯而任意增加其他權限，也不要繞過 Discord 平台要求。
Token 無效表示 Discord 沒有接受所提供的 Token。核對是否取自目前使用的機器人、是否完整貼上，以及保存的是不是預期連線。若顯示不可用，則依提示分別檢查網路、Token 與 Intent；只改其中一項後再觀察，避免一次改完而不知道原因。
Token 是秘密，不是診斷資料。不要把它放進 Discord 私訊、公開截圖或支援紀錄；截圖前遮蔽整段。若已外洩，透過官方 Developer Portal 重設，再更新 FoneClaw 保存的憑證，不繼續使用曝光的值。伺服器安裝完成，也不代表 FoneClaw 支援在伺服器頻道接收任務，下一步仍是機器人私訊。
用正確帳號在十分鐘內完成私訊配對
保存連線後，在十分鐘內用預定帳號私訊機器人 hello。連線會綁定第一個傳送訊息的 Discord 帳號，因此開始前先確認登入的是自己要使用的帳號，不請別人代傳測試訊息。
打開已安裝機器人的個人資料，確認你正在和那個機器人私訊。把 hello 寫在伺服器文字頻道、傳給另一個機器人，或使用不同帳號，都不能當成預期配對已完成的證據。FoneClaw 這條入口只支援直接私訊。
若配對已逾期，就回到 FoneClaw 重新開始配對，再於新的期限內傳送。若先前用錯帳號或對話，先查看手機上的綁定與連線狀態，依實際設定重新處理；不要只在原對話反覆傳 hello，假設綁定已改到另一個帳號。
配對完成後，再用同一帳號、同一機器人私訊查看狀態。要確認的是連線及帳號關係，而不是立即建立一筆行事曆或寄出內容。若你其實正在設定 Telegram，請改用FoneClaw 連接 Telegram 機器人：BotFather 建立、配對與排障指南，不要把 Telegram 憑證與設定步驟套到 Discord。
查看佇列，再處理手機權限與核准
在已配對私訊中使用 /status，可查看執行中與排隊請求的數量。這能區分「請求已接收但還在等」與其他問題；若指令本身沒有回應，仍要回查連線和傳送狀態，不能直接判定佇列為空。
遇到佇列已滿，先等現有工作處理，或在確定要放棄目前與排隊請求時使用 /stop。若顯示佇列正在停止，稍後再試，不連續加入新請求。數量能說明負載，不能單靠它證明某項手機動作成功。
接著到 Android 手機查看 FoneClaw 任務。所選模型負責理解與規劃，已啟用工具則受 Android 權限及全域、個別工具核准政策控制。Discord 配對不會授予行事曆或其他手機權限，供應商連線設定也不等於工具已可執行。
若待核准，先查看要執行的內容與目的地，再決定允許或取消。若缺少權限，按實際提示處理相關項目；不是每項動作都會詢問，也不應為一個失敗要求全面開放權限。權限處理完成後，查看原任務是否已恢復，而不是立即再送一份。
最後核對結果。建立個人待辦時，查看保存文字與日期；未提供明確日期的內容應保留未排程。建立行事曆時，核對帳號、日期、起訖時間、提醒與實際事件。支援動作可在FoneClaw 功能頁查看；不需要先重設手機或全面取消省電限制來定位這一層。
先復原結果傳送，不重複手機動作
/retry 的用途是把已保存的結果重新排入傳送，不是重新執行手機任務。當 Android 已完成操作，但 Discord 結果沒有送達時，先處理回傳，才能避免重複副作用。
以下是假設情境，不是實測：你要求建立一筆日期與時間已確認的「專案討論」事件。手機行事曆已有該事件，Discord 卻沒收到結果。先核對事件的帳號、日期、起訖與提醒，再在已配對私訊使用 /retry，查看保存結果是否能重新傳送。不要再次傳「建立專案討論」，因為那是新的執行要求，可能多建一筆。
| 目前觀察 | 處理方式 |
|---|---|
| 目的地已有正確項目，結果回傳失敗 | 優先嘗試 /retry 傳送已保存結果 |
| /retry 表示沒有可復原的傳送失敗 | 表示沒有可用的已保存失敗結果，不代表手機未執行 |
| 請求已逾期或連線已改變 | 先查看手機任務與目前連線，再決定下一步 |
| 目的地與任務狀態都不明 | 暫停新寫入，補查原請求，不盲目重送 |
即使 /retry 已排入傳送，也要查看是否真的收到結果。它不能修復缺少的 Android 權限，也不能補做原本沒執行的動作。若沒有可復原結果，回到手機查原任務及目的地，將狀態分成已完成、確認未完成或仍不明；只有確認需要新的執行時，才另行提出明確請求。
/stop 會停止目前及排隊請求，但不撤銷已完成操作。停止後，已建立的事件或待辦仍需查看；若要修改或刪除，另行選定正確項目處理。FoneClaw 安全說明也說明權限、核准與外部效果的邊界。需要分清手機任務、雲端工作與排程，可閱讀如何停止 Android AI 代理？分清手機任務、雲端工作與排程。
用小請求確認恢復，留下安全診斷資料
修正設定後，先做一項不造成手機寫入的檢查：從已配對私訊送出 /status，確認收到狀態。如果仍沒有回應，繼續查連線或回傳，不用寄送訊息、建立事件來測試。
需要確認一般請求能執行時，可再要求「準備一句文字：我稍後確認，先不要寄送，也不要保存到其他 App」。這是建議的有限範圍檢查；完成點是收到預期草稿，不是通訊動作已發生。若你原本的問題涉及寫入，仍需另外查該任務的目的地。
- 記錄發生時間、錯誤原文，以及當時使用哪個帳號與機器人，分享前遮蔽不必要的識別資訊。
- 標明卡在連線、配對、請求接收、佇列、權限、核准、執行或結果傳送哪一段。
- 保留 /status、/retry 或 /stop 的實際回應，不把沒有回覆寫成確定未執行。
- 記下手機任務狀態與目的地是否已有結果；截圖排除私人內容。
- 不附 Token、API 金鑰、完整私人訊息或其他秘密。
若問題已超出 Discord 入口，例如手機工具持續失敗或部分完成，可接著用手機 AI 代理失敗除錯與復原指南：根因分析、權限修復與安全重跑處理。每次只修正一個被阻擋的環節，再查看原任務與實際結果，才能知道恢復的是連線、執行，還是回傳。