遠端 Mac CI 節點串接 OpenClaw 技能鏈與 MCP 時，版本、路徑與閘道暴露面最易出錯。依官方安裝文件（openclaws.io/docs/install），建議 Node 24，相容 Node 22.16+ LTS；請在官方
install.sh 與 npm install -g openclaw@latest 擇一。本文含 HowTo、閘道綁 127.0.0.1 與 Token、launchd 常駐、報錯表、最小 workspace、定時拉取加預檢例。延伸ClawHub 預拉取教學；首頁、購買頁免登入可瀏覽。
遠端 Mac CI 節點上技能鏈與 MCP 的三類痛點
- 版本漂移：低於官方 Node 下限時 CLI 與原生模組易編譯失敗，CI 難重現。
- 閘道暴露：
0.0.0.0無 ACL 等同控制面公網裸奔，應改127.0.0.1並驗 Token。 - 未常駐：僅手動啟動會在重開機或 SSH 結束後遺失閘道，CI 前置隨機失敗。
安裝入口擇一：官方腳本與 npm 全局對照
官方建議腳本：偵測 Node、全局裝 CLI 並 onboarding。已自管 Node 者可用 npm 全局；擇一後固定升級路徑並寫入 Runbook。
| 方式 | 適用 | 指令摘要 | 維運提示 |
|---|---|---|---|
| 官方腳本 | 乾淨節點、要少決策 | curl -fsSL https://openclaw.ai/install.sh | bash | 可補 bash -s -- --no-onboard 僅裝二進位；之後再跑 openclaw onboard --install-daemon |
| npm 全局 | 已固定 Node 的 CI 映像 | npm install -g openclaw@latest 後 openclaw onboard --install-daemon | 確認 $(npm prefix -g)/bin 在 PATH；sharp 編譯問題可設 SHARP_IGNORE_GLOBAL_LIBVIPS=1 |
可複現落地步驟（HowTo 清單）
1
版本自檢：執行 node -v、npm -v，目標對齊官方「Node 24 建議／22.16+ LTS 相容」敘述，必要時用 nvm 或映像鎖版。
2
擇一安裝：採腳本或 npm 全局其一；完成後以 openclaw doctor、openclaw status 驗證，必要時設定 OPENCLAW_HOME 或 OPENCLAW_CONFIG_PATH 便於多租戶隔離。
3
技能鏈與 MCP：openclaw.json 啟用技能並於 mcpServers 宣告子行程與環境變數；預檢寫入 scripts/preflight.sh 供技能或排程呼叫。
4
閘道與 Token：listen 設 127.0.0.1，客戶端經本機或受控隧道；強隨機 Token 放標頭或環境變數並輪替，勿讓 0.0.0.0 無 ACL 對外。
5
常駐：openclaw onboard --install-daemon 後，macOS 可再以 launchd 設 RunAtLoad、KeepAlive。Runbook 可連結說明中心。
常見報錯對照表
| 現象或訊息 | 可能原因 | 建議處置 |
|---|---|---|
openclaw: command not found | npm 全局 bin 不在 PATH | export PATH="$(npm prefix -g)/bin:$PATH" 並寫入 ~/.zshrc |
sharp 或原生模組編譯失敗 | 系統 libvips 與預建二進位衝突 | 依官方文件設 SHARP_IGNORE_GLOBAL_LIBVIPS=1 後重裝 |
| 閘道連線被拒或誤連到他機 | 綁錯介面或未走本機隧道 | 改 127.0.0.1，搭配 SSH 反代或 mTLS／Token |
| 401／403 | Token 缺失、過期或外洩後被撤銷 | 輪替祕鑰、檢查標頭名稱與環境變數注入是否一致 |
最小可複現 workspace 目錄結構
分層放置便於版控與快取掛載：
openclaw-ci-workspace/ ├── openclaw.json # 技能與 mcpServers 設定 ├── skills/ # ClawHub 或本機技能描述（依實際工具為準） ├── scripts/ │ └── preflight.sh # 節點預檢：Node 版本、openclaw doctor、MCP 健康檢查 └── logs/ # 排程與預檢輸出（可輪替）
與定時拉取、預檢結合的一例
launchd 每小時進 workspace：git pull 後跑 scripts/preflight.sh；成功則本機 curl 打 127.0.0.1 健康檢查並帶 Token，再觸發 CI 或通知。
可引用資訊（審計／Runbook）
直接寫進文件
- 版本基線：Node 24 建議；Node 22.16+ LTS 仍受支援（以官方文件為準）。
- 安裝來源：
https://openclaw.ai/install.sh與npm install -g openclaw@latest擇一。 - 安全預設：閘道
127.0.0.1、強隨機 Token、避免公網裸監聽0.0.0.0。