遇到問題？這份疑難排解指南幫你快速脫困
寫程式最煩的就是環境跑不起來，或是 Gateway 突然連不上。有時候你只是想趕快把功能做出來，卻卡在 Node.js 版本不對或 PATH 設定這種瑣事上，看著螢幕發呆真的會讓人很挫折。
這份指南幫你整理了最常遇到的問題，讓你不用在大海裡撈針，直接找到解決辦法。
需要準備的東西
Section titled “需要準備的東西”在開始排查之前，請確保你已經準備好以下項目：
- 已安裝 Node.js 與 npm
- 已設定好系統的 PATH 路徑
- 存取 Gateway 的權限
如果你現在正卡在某個地方，請按照這個「脫困流程」操作，通常 5 分鐘內就能找到原因：
- 檢查環境安裝：到 Install 確認你的 Node.js 和 npm 設定沒問題。
- 執行自我修復：使用 Doctor 工具自動檢查 Gateway 狀態。
- 查看日誌：檢查 Logging 和 Gateway logging 裡的錯誤訊息。
- 排查 Gateway：如果問題出在連線上，直接看 Gateway troubleshooting。
這裡收集了開發者最常遇到的狀況，你可以根據分類快速跳轉：
- 我想快速修復錯誤：請參考 故障排除總覽。
- 我的 Gateway 連不上：請查看 Gateway 疑難排解。
- 我想看系統日誌：請參考 一般日誌 與 Gateway 日誌 說明。
- 我對概念有疑問：如果你不是遇到程式報錯，而是想了解背後的邏輯，請看 FAQ (concepts)。
如果你試了以上方法還是搞不定，可以試試我們的 AI Setup Assistant，它能根據你的具體情況提供建議。
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。