openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

如果你想再深入啲排查，官方建議咗一個「60 秒黃金診斷流程」，啱晒啲頑固嘅情況。

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

健康狀態應該睇到咩

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

• 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 頭幾十行嘅 output 抄低，咁就個個大神都可以即刻幫你斷到症。

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

如果你想再深入啲排查，官方建議咗一個「60 秒黃金診斷流程」，啱晒啲頑固嘅情況。

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

健康狀態應該睇到咩

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

• 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 頭幾十行嘅 output 抄低，咁就個個大神都可以即刻幫你斷到症。