若你串接的是 Telegram 機器人,以下是最常見的四種故障特徵與檢修方向:
如果你看到機器人顯示「在線上」,但在群組內傳訊息它卻毫無反應,這通常不是程式當機,而是 Telegram 的隱私權設定在搞鬼。根據 OpenClaw 的 Telegram 文件,你必須檢查 requireMention(需要提及)設定,以及機器人的隱私模式。
/setprivacy 指令來關閉,或是直接將機器人設為群組管理員。注意:更改設定後,請務必將機器人從群組中移除並重新加入,好讓 Telegram 伺服器套用新的權限設定。getMe returned 401如果在 Gateway 啟動日誌中看到此錯誤,代表你從 BotFather 取得的 Token(權杖)已經輸入錯誤、失效或遭到撤銷。
botToken、tokenFile,或是檢查環境變數 TELEGRAM_BOT_TOKEN 是否輸入正確。發送訊息時若出現網路錯誤(Network error),或是長期輪詢(Long polling)經常無預警停滯、重連緩慢,官方文件指出最常見的元兇是機器人伺服器到 api.telegram.org 之間的路由障礙。
openclaw logs --follow 中觀察具體的 API 錯誤訊息。接著檢查伺服器的 DNS 解析、IPv6 設定,或是正在使用的代理伺服器路由是否正常,確保能順利連線至 Telegram 後端。getUpdates 409 Conflict這是一個很經典的邏輯錯誤。OpenClaw 的架構設計保障每個 Gateway 程序中只能有一個活躍的輪詢器使用相同的機器人 Token。如果你看到 409 錯誤,這意味著有不只一個 OpenClaw 實例、外部腳本或是其他輪詢程式正在爭奪同一個機器人 Token。
如果你是在升級 OpenClaw 版本後才遇到故障,不要直接重開機。官方文件建議先執行 openclaw status --all 查看是否有依賴樹損毀(Dependency tree corrupted)的報錯。如果日誌有提到 plugin load failed,這代表頻道設定還在,但外掛程式載入時發生衝突。
openclaw doctor --fix。這個指令會幫你清除舊的暫存與授權陰影。清理完畢後再執行 openclaw gateway restart,最後重新檢查狀態。為了排除設定面的人為失誤,這裡快速複習一下 OpenClaw 串接 Telegram 的正確姿勢:它並不需要執行 openclaw channels login telegram。你只需要將 Token 寫入設定檔或環境變數,開啟 channels.telegram.enabled: true,然後啟動 Gateway 即可。
openclaw pairing list telegram 來查看待批准的請求,並手動批准配對碼。在沒有取得上述五道命令的輸出結果前,貿然修改設定檔通常只會越改越糟。如果你正在處理 Telegram 機器人的問題,可以先鎖定最可疑的四大方向:隱私/提及設定、Token 401、DNS/代理路由,或是 輪詢衝突 409。蒐集完明確的報錯資訊後,要對症下藥就容易多了。
若你串接的是 Telegram 機器人,以下是最常見的四種故障特徵與檢修方向:
如果你看到機器人顯示「在線上」,但在群組內傳訊息它卻毫無反應,這通常不是程式當機,而是 Telegram 的隱私權設定在搞鬼。根據 OpenClaw 的 Telegram 文件,你必須檢查 requireMention(需要提及)設定,以及機器人的隱私模式。
/setprivacy 指令來關閉,或是直接將機器人設為群組管理員。注意:更改設定後,請務必將機器人從群組中移除並重新加入,好讓 Telegram 伺服器套用新的權限設定。getMe returned 401如果在 Gateway 啟動日誌中看到此錯誤,代表你從 BotFather 取得的 Token(權杖)已經輸入錯誤、失效或遭到撤銷。
botToken、tokenFile,或是檢查環境變數 TELEGRAM_BOT_TOKEN 是否輸入正確。發送訊息時若出現網路錯誤(Network error),或是長期輪詢(Long polling)經常無預警停滯、重連緩慢,官方文件指出最常見的元兇是機器人伺服器到 api.telegram.org 之間的路由障礙。
openclaw logs --follow 中觀察具體的 API 錯誤訊息。接著檢查伺服器的 DNS 解析、IPv6 設定,或是正在使用的代理伺服器路由是否正常,確保能順利連線至 Telegram 後端。getUpdates 409 Conflict這是一個很經典的邏輯錯誤。OpenClaw 的架構設計保障每個 Gateway 程序中只能有一個活躍的輪詢器使用相同的機器人 Token。如果你看到 409 錯誤,這意味著有不只一個 OpenClaw 實例、外部腳本或是其他輪詢程式正在爭奪同一個機器人 Token。
如果你是在升級 OpenClaw 版本後才遇到故障,不要直接重開機。官方文件建議先執行 openclaw status --all 查看是否有依賴樹損毀(Dependency tree corrupted)的報錯。如果日誌有提到 plugin load failed,這代表頻道設定還在,但外掛程式載入時發生衝突。
openclaw doctor --fix。這個指令會幫你清除舊的暫存與授權陰影。清理完畢後再執行 openclaw gateway restart,最後重新檢查狀態。為了排除設定面的人為失誤,這裡快速複習一下 OpenClaw 串接 Telegram 的正確姿勢:它並不需要執行 openclaw channels login telegram。你只需要將 Token 寫入設定檔或環境變數,開啟 channels.telegram.enabled: true,然後啟動 Gateway 即可。
openclaw pairing list telegram 來查看待批准的請求,並手動批准配對碼。在沒有取得上述五道命令的輸出結果前,貿然修改設定檔通常只會越改越糟。如果你正在處理 Telegram 機器人的問題,可以先鎖定最可疑的四大方向:隱私/提及設定、Token 401、DNS/代理路由,或是 輪詢衝突 409。蒐集完明確的報錯資訊後,要對症下藥就容易多了。