01痛點拆解:安裝路徑混用、Node 版本與十六吉位元組峰值
在預算遠端 Mac上跑 OpenClaw,常見三類入門摩擦。
- 痛點一:同一台機器混用install.sh與npm -g,
which openclaw指向不同前綴,doctor 持續報錯。 - 痛點二:系統預設 Node 仍為舊版,未達二十四主版本,onboard 中途失敗卻難以回溯。
- 痛點三:Skills 冷啟動瞬間吃滿磁碟快取與統一記憶體,M4 16GB 在第二路互動時交換,誤判為網路問題。
02install.sh 與 npm -g 路徑對照表
下列矩陣供入門安裝決策;進階儲存與併發見OpenClaw 儲存決策矩陣。
| 維度 | 官方 install.sh | npm install -g |
|---|---|---|
| 適合情境 | 首次驗證、腳本一鍵補依賴 | 鎖版 CI、需精確 @x.y.z |
| Node 24 | 腳本內建版本檢查 | 須先手動 node -v 過關 |
| 升級風險 | 跟隨發行頻道 | package-lock 可審計 |
| 預算團隊建議 | 日租驗收優先 | 驗收通過後再鎖版 |
03openclaw onboard --install-daemon 驗收步驟
SSH 登入 vuzcloud 節點後,建議依序執行下列檢查(細節以官方文件為準)。
- 步驟 1:
node -v主版本為 24;不足則nvm install 24後重開 shell。 - 步驟 2:以
curl -fsSL …/install.sh | sh或npm i -g openclaw@版本二選一,勿混裝。 - 步驟 3:
openclaw onboard --install-daemon完成工作區與守護行程註冊。 - 步驟 4:
openclaw gateway status顯示監聽中且埠未被占用。 - 步驟 5:
openclaw doctor無紅色項後,再載入首個 Skill 做冷啟動量測。
04Skills 冷啟動:磁碟/記憶體峰值閾值
在 Mac mini M4 16GB 上,建議以單次冷啟動紀錄下列水位(與儲存矩陣對齊)。
| 指標 | 可接受 | 建議升級或拆機 |
|---|---|---|
| 可用磁碟(冷啟動後) | ≥ 三十吉位元組 | < 三十吉位元組或連續觸發清理 |
| 統一記憶體壓力 | 單路互動 + 一個 Skill | 兩路互動且出現交換 |
| 併發會話 | ≤ 二路輕量對話 | 第三路或重 Skill 並行 |
05美西/亞太節點如何選擇
安裝本身與區域無關,但閘道對外呼叫會受 RTT 影響;請併讀API RTT 成本矩陣。
| 訊號 | 優先美西 | 優先亞太 |
|---|---|---|
| 北美 SaaS/模型 API | 控制面延遲較低 | 跨洋需加長逾時 |
| 版控與審查在東亞 | 適合跑 Transporter 離岸任務 | git 與內網閘道較順 |
06落地步驟(五步,可貼變更單)
- 一:於 購買頁 選入門 M4 16GB與區域,依支援中心完成 SSH。
- 二:確認 Node 24 並選定 install.sh 或 npm -g 單一路徑。
- 三:執行
openclaw onboard --install-daemon與gateway status。 - 四:冷啟動 Skill,紀錄磁碟與記憶體是否低於上文閾值。
- 五:連續使用達五日,依租期矩陣比對日租/週租刊例。
07可引用檢核點
08gateway status/doctor 常見報錯 FAQ
問:gateway status 顯示未監聽?
答:確認 --install-daemon 是否完成;執行 openclaw gateway stop 後再 start,並檢查埠占用。
問:doctor 報 Node 版本不符?
答:同一 shell 內切到 Node 24 後重裝全域套件,避免 npm 與 install.sh 混用。
問:冷啟動後磁碟告警?
答:改選五百一十二吉位元組入門方案或拆第二台;見儲存矩陣。
對照儲存/Transporter 博文,選購 M4 入門套餐
延伸閱讀預算儲存決策矩陣與美西 Transporter 實戰;首頁總覽方案,購買頁選十六吉位元組入門機,定價頁對低價刊例。