故障排查2026-03-255 分钟
修复 macOS 上的 npm 安装失败
多数 npm 安装错误都与本地环境有关，关键是先判断问题来自版本、权限还是路径冲突。
先缩小根因
优先检查 Node 版本、架构、缓存和 Homebrew 相关路径，避免一上来全局重装一切。
什么时候该切换路径
如果你只是想尽快跑通系统，直接使用 Docker 或托管平台，通常比继续修脏环境更有效率。
开始使用
别再让本地包管理问题拖慢进度
先修关键环境项，再判断是否该直接切到更稳的部署路径。
相关页面
常见问题
这类问题最常见的根因是什么？
通常是 Node 版本不匹配、架构混用、缓存损坏或权限配置不对，而不是 OpenClaw 本体本身出了问题。
修到什么程度就该换部署路径？
如果环境问题已经开始重复消耗你的时间，而目标只是尽快跑通系统，就应该优先改走 Docker 或托管路径。