01前置檢查清單(系統、磁碟、網路)
- macOS:對照官方最低版本;映像過舊易卡 Xcode/CLT。
- 磁碟:系統卷宗建議至少約 10GB余量供模組、日誌與快取。
- 網路:需白名單者先確認固定或可預測出口 IP。🔗
02安裝分岔:一鍵、Homebrew、隔離思路
A|一鍵:curl -fsSL https://openclaw.ai/install.sh | bash。成功應可呼叫 openclaw;curl 憑證錯誤先查代理與 MITM。
B|Homebrew:brew install openclaw/tap/openclaw 後 openclaw init、openclaw start。連線失敗多為 GitHub/CDN 被擋,保留 brew --verbose 輸出。
C|隔離:與他服並存可評估容器;勿把金鑰寫在多人可讀共享卷宗。
xcodebuild -version、node -v 再升工具鏈。03節點選擇:控制台延遲對上 API 區域
權衡SSH/瀏覽器體感與貼近 API 區;毫秒請自測。
| 決策焦點 | 亞太節點 | 美西節點 |
|---|---|---|
| 東亞操作 VNC/瀏覽器 | 較順 | 跨洋易頓 |
| 美西 LLM/SaaS API | 可用,往返長 | 路徑直 |
| Gateway 主要使用者 | 東亞為主較均衡 | 北美或美區合規為主較佳 |
設定多在 ~/.openclaw/openclaw.json;Gateway常見埠 18789(以當版為準)。常駐可試 openclaw onboard --install-daemon;面板用 openclaw dashboard(皆以 openclaw --help 為準)。
若團隊同時需要低延遲控制台與貼美區 API,可於 neokvm 分租亞太與美西各一台,以 SSH 腳本同步部署相同安裝路徑,降低單點變更風險。
04並聯資源:多實驗對照單機高配
並行測多組 Agent 時,兩台低配遠端 Mac利於對照與回滾;負載已穩定再收斂單節點。
05儲存與快取目錄規劃
- 日誌:用可輪替路徑,勿堆在家目錄根。
- 模型快取:獨立子目錄並定期清;必要時擴容。
- pnpm/npm 快取:固定根目錄並在腳本內清理,避免重複
install膨脹。
06排障路徑:Gateway Starting、埠、TCC、版本
- Gateway Starting 卡住:看日誌尾段是否等憑證、DNS、下載;查時鐘與代理。
- 埠占用:
lsof -i :18789(或自訂埠)找行程後優雅重啟。 - TCC:首次授權常需 GUI;僅 SSH 時預先規劃螢幕錄製等權限流程。
- 版本:對
openclaw --version與文件;不符則備份設定後改裝相容版。
07實務工作流:SSH 與本機瀏覽器
SSH維護遠端程序,本機瀏覽器經通道開 dashboard;勿將管理埠裸曝公網,應限來源 IP 或僅本機監聽再轉發。詳見 help.html、說明中心。
08可引用重點(摘要條列)
- 一鍵:
curl -fsSL https://openclaw.ai/install.sh | bash;失敗保留完整輸出。 - 設定/埠:
~/.openclaw/openclaw.json、常見 18789;子命令以openclaw --help為準。 - 節點:亞太利東亞互動,美西貼美區 API;並聯低配利實驗切割。
openclaw --help 與官方文件為準,並於變更後重跑健康檢查腳本。
為 OpenClaw Gateway 選對出口與並聯實例
於購買頁選擇美西或亞太節點,並以多台實例拆分實驗與正式流量;完成後再依定價頁核對擴容與租期。