跳到內容

openclaw logs --follow 指令指南

openclaw logs --follow 是排查 OpenClaw 問題時最直接、最快速的方式。

當你遇到啟動失敗、Channel 沒反應、Provider 呼叫異常時,先開這條指令。

Terminal window
openclaw logs --follow

建議搭配:

Terminal window
openclaw doctor
openclaw gateway status
openclaw channels status --probe

你應該看到穩定啟動與持續活動,不應重複出現致命錯誤。

如果反覆出現:

  • Gateway start blocked: set gateway.mode=local

請直接查看:

若出現這類字樣:

  • unauthorized
  • gateway connect failed
  • missing_scope

請繼續看:

Terminal window
openclaw logs
openclaw logs --limit 500
openclaw logs --json
  • openclaw logs: 查看最新輸出
  • --limit: 往前拉更多歷史紀錄
  • --json: 便於機器解析與管線處理
  1. 在一個終端機持續跑 openclaw logs --follow。
  2. 在實際 channel 發送一條測試命令。
  3. 對照日誌與預期處理流程。
  4. 若仍卡住,整理關鍵輸出後詢問 docs assistant。
OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。