故障排查2026-03-255 分鐘
修復 macOS 上的 npm 安裝失敗
多數 npm 安裝错誤都與本地環境有關，關键是先判斷問題來自版本、權限還是路徑衝突。
先縮小根因
優先檢查 Node 版本、架构、缓存和 Homebrew 相關路徑，避免一上來全局重裝一切。
什么時候該切换路徑
如果你只是想尽快跑通系統，直接使用 Docker 或托管平台，通常比继续修脏環境更有效率。
開始使用
別再让本地包管理問題拖慢進度
先修關键環境項，再判斷是否該直接切到更穩的部署路徑。
相關頁面
常見問題
這類問題最常見的根因是什么？
通常是 Node 版本不匹配、架构混用、缓存损坏或權限配置不對，而不是 OpenClaw 本體本身出了問題。
修到什么程度就該换部署路徑？
如果環境問題已经開始重復消耗你的時间，而目標只是尽快跑通系統，就應該優先改走 Docker 或托管路徑。