OpenClaw 聊天機械人停咗唔郁？跟住呢個步驟逐樣排查

健康狀態應該睇到咩

行完上面啲命令，正常嚟講你應該要見到呢啲結果，先代表個底層冇病：

• openclaw gateway status

  一定要出

  Runtime: running

  同埋

  Connectivity probe: ok

  。

• openclaw channels status --probe

  要顯示傳輸層已連接，支援嘅頻道會見到 works 或者

  audit ok

  。

• openclaw status

  唔應該有明顯嘅授權錯誤（auth error）或者設定錯誤（config error）。

只要是但一點唔符合，就跟住下面嘅分類去搵解決辦法。

如果係更新之後先出事

好多人係一更新完，個機械人就即刻變咗啞巴。官方文件講明，呢個情況好大機會係外掛或者設定檔炒咗。

• 即刻行

  openclaw status --all

  睇清楚報告。
• 然後用

  openclaw doctor --fix

  進行自動修復。官方話呢個命令會幫你清走損壞嘅外掛暫存檔同舊嘅授權陰影檔。
• 最後用

  openclaw gateway restart

  重新啟動個閘道，再行多次

  openclaw status --all

  確認修復成功。
• 如果你見到句

  plugin load failed: dependency tree corrupted

  ，更加證明係外掛路徑炒咗，

  openclaw doctor --fix

  就係官方指定嘅解藥。

如果你係用 Telegram 機械人出事

Telegram 係重災區，佢「企咗喺度」嘅樣有幾款，要分開處理：

• Bot 在線但回覆唔用得：即係撳 /start 有反應，但啲指令或者正常對話全部冇回應。呢個時候要先檢查

  openclaw pairing list telegram

  ，睇吓配對係咪甩咗。
• 喺群組入面變啞巴：呢個十之八九係 Telegram 嘅私隱模式（Privacy Mode）作怪。Bot 預設睇唔到冇 @佢嘅訊息，你要去 BotFather 度取消呢個設定，或者叫啲 group 友 send 訊息前加返個 bot 名。
• Log 報網絡錯誤：即係駁唔到 Telegram 嘅 API 伺服器。呢個通常係你個網路環境嘅 DNS、IPv6 或者 Proxy 路由有問題，要檢查吓個網路設定。
• 啟動時就報 Token 401 錯誤：Token 過期或者錯咗。你要去 BotFather 度重新 Generate 個 Token，然後喺你嘅 config 檔入面更新返個 botToken、tokenFile，或者環境變數 TELEGRAM_BOT_TOKEN。
• Polling 停頓或者重連慢：行

  openclaw logs --follow

  睇住個 Log，如果見到佢係咁重試但唔成功，多數都係上述嘅網路問題（DNS/IPv6/Proxy）引致。

如果根本係 Gateway 死咗

Gateway 係成個系統嘅心臟，佢一死就乜都唔使玩。Gateway 出事通常有兩個特徵：

• 行錯咗舊版本嘅程式：你嘅系統環境變數 PATH 指錯咗去一個舊版嘅 openclaw 執行檔。官方解法係修改 PATH，確保佢指返去新安裝嗰個版本，然後先再行一次你嘅動作。
• 服務或者包裝器太舊：你安裝嗰個 Gateway 服務可能係用緊舊版嘢。官方建議直接用新版嘅安裝包重裝一次 Gateway 服務，同埋清走晒啲過時嘅系統服務檔或者包裝器（Stale Wrappers）。

懶人包：睇症狀直接跳去查邊度

搞唔清楚自己係邊種死法？呢個表幫到你：

• Gateway 冇著 / Probe 失敗 → 直接查 Gateway 嗰 part：PATH 設定、服務狀態、有冇裝錯版。
• Gateway 著咗但機械人唔答嘢 → 問題喺頻道嗰邊：檢查頻道配對、@提及要求、私隱模式、Token 同網路。
• 更新完先企咗喺度 → 第一時間用

  doctor --fix

  然後重啟 Gateway。
• Log 係咁重複致命錯誤 → 唔係單純「窒機」，而係設定檔或者外掛真係出咗事，一定要執返好。

總之，下次再見到 OpenClaw 「企咗喺度」，唔好再靠估或者亂咁改 config。乖乖哋行一次上面嗰幾句基本診斷命令，望吓個 Log 到底講咗乜，通常好快就可以搵到係邊個環節出咗事。 如果真係搞唔掂，將

openclaw gateway status

openclaw channels status --probe

openclaw logs --follow