AI 自動化
2026年4月7日
2026 雲端 Mac：OpenClaw install.sh 與 npm 全域安裝——選型、驗證與安全升級
MacLogin AI 自動化團隊
2026年4月7日
約 8 分鐘
OpenClaw 提供多種安裝路徑。在租用的 Apple Silicon 雲端 Mac 上，通常需要可重複的升級、單一的閘道二進位來源，以及與 Runbook 一致的日誌。
請先閱讀 OpenClaw 部署指南、閘道守護行程排查、Node 環境與前置條件，再變更正式閘道。
何時優先 install.sh
- 希望與官方文件預設路徑一致。
- 值班輪替頻繁，少改 PATH 可降低事故。
- 搭配 MacLogin 建議的 launchd 模板。
何時優先 npm 全域
- 已用 nvm/asdf 鎖定 Node 大版本。
- 需並行測試多個 CLI 大版本。
- 安全流程要求 npm audit。
對照表
| 面向 | install.sh | npm -g |
|---|---|---|
| PATH 風險 | 較低 | 較高 |
| 升級 | 重跑腳本 | npm update -g |
| 閘道恢復 | 與上游文件一致 | 確認 launchd 使用的 node |
提示： 勿在同一前綴混裝兩種方式——選定一種並寫入 CMDB。
驗證清單
node -v與 plist 一致。- 非登入 SSH 下執行 which，路徑需穩定。
- 先在雲端本機檢查閘道健康狀態。
- 重啟 launchd 時查看日誌。
升級不留孤兒二進位
記錄舊路徑，移除舊 npm 全域套件後重裝。失敗時參考 閘道排查 與 部署指南。
常見問題
簡答與結構化 FAQ 對齊。
可以混用 install.sh 與 npm 嗎？ 僅在清楚分隔前綴並文件化時可行。
MacLogin 會鎖 Node 嗎？ 租約內執行環境仍由你治理。
升級後隧道失效？ 檢查 LocalForward 與 loopback 監聽。
