OpenClaw 機器人掛了別慌！照著這份檢查清單自救

雖然目前握有的證據還不足以直接判定機器人的確切死因，但排查路徑已經非常清晰。OpenClaw 官方文件要求，當「連線看似正常但行為異常」時，管理者必須依序運行以下診斷指令階梯來擷取病歷：

五式診斷階梯：先確認底盤是否健康

在忙著修改設定檔之前，請先在終端機中依序輸入這五道命令，並仔細觀察輸出結果：

1. openclaw status

2. openclaw gateway status

3. openclaw logs --follow

4. openclaw doctor

5. openclaw channels status --probe

一個功能健全的基準線（Healthy baseline）應包含以下特徵：運行時狀態顯示為 running、連線探測結果為 ok、具備合法的讀寫能力（Capability），且頻道探測顯示傳輸層已連接，在支援的環境下還需顯示 works 或

audit ok

Telegram 頻道四大疑難雜症快查

若你串接的是 Telegram 機器人，以下是最常見的四種故障特徵與檢修方向：

1. 群組如死水：機器人在線但全群靜默

如果你看到機器人顯示「在線上」，但在群組內傳訊息它卻毫無反應，這通常不是程式當機，而是 Telegram 的隱私權設定在搞鬼。根據 OpenClaw 的 Telegram 文件，你必須檢查 requireMention（需要提及）設定，以及機器人的隱私模式。

• 解法：若希望機器人能讀取群組內所有的對話，必須關閉隱私模式。你可透過聊天室輸入 /setprivacy 指令來關閉，或是直接將機器人設為群組管理員。注意：更改設定後，請務必將機器人從群組中移除並重新加入，好讓 Telegram 伺服器套用新的權限設定。

2. 啟動報錯：

getMe returned 401

如果在 Gateway 啟動日誌中看到此錯誤，代表你從 BotFather 取得的 Token（權杖）已經輸入錯誤、失效或遭到撤銷。

• 解法：你需要更新設定檔中的 botToken、tokenFile，或是檢查環境變數 TELEGRAM_BOT_TOKEN 是否輸入正確。

3. 網路不穩：發送失敗或輪詢停滯

發送訊息時若出現網路錯誤（Network error），或是長期輪詢（Long polling）經常無預警停滯、重連緩慢，官方文件指出最常見的元兇是機器人伺服器到 api.telegram.org 之間的路由障礙。

• 解法：請在

  openclaw logs --follow

  中觀察具體的 API 錯誤訊息。接著檢查伺服器的 DNS 解析、IPv6 設定，或是正在使用的代理伺服器路由是否正常，確保能順利連線至 Telegram 後端。

4. 輪詢衝突：getUpdates 409 Conflict

這是一個很經典的邏輯錯誤。OpenClaw 的架構設計保障每個 Gateway 程序中只能有一個活躍的輪詢器使用相同的機器人 Token。如果你看到 409 錯誤，這意味著有不只一個 OpenClaw 實例、外部腳本或是其他輪詢程式正在爭奪同一個機器人 Token。

• 解法：請確保同一個 Bot Token 只有一個 OpenClaw Gateway 在使用，如果有其他排程或測試腳本在背景執行，請將它們終止。

更新後才掛點？先讓醫生動手術

如果你是在升級 OpenClaw 版本後才遇到故障，不要直接重開機。官方文件建議先執行

openclaw status --all

plugin load failed

• 標準救治流程：執行

  openclaw doctor --fix

  。這個指令會幫你清除舊的暫存與授權陰影。清理完畢後再執行

  openclaw gateway restart

  ，最後重新檢查狀態。

正確的 Telegram 設定流程回顧

為了排除設定面的人為失誤，這裡快速複習一下 OpenClaw 串接 Telegram 的正確姿勢：它並不需要執行

openclaw channels login telegram

channels.telegram.enabled: true

• 私訊配對機制：Telegram 預設使用配對（Pairing）機制來管理私訊權限。Gateway 啟動後，請執行

  openclaw pairing list telegram

  來查看待批准的請求，並手動批准配對碼。

結語：別急著瞎改，先給對病歷

在沒有取得上述五道命令的輸出結果前，貿然修改設定檔通常只會越改越糟。如果你正在處理 Telegram 機器人的問題，可以先鎖定最可疑的四大方向：隱私/提及設定、Token 401、DNS/代理路由，或是 輪詢衝突 409。蒐集完明確的報錯資訊後，要對症下藥就容易多了。