2026年 OpenClaw Playwright skill-browser 在無頭 Mac VPS 部署：Chromium 同帳戶安裝、並行上限與報錯對照 Runbook（含決策矩陣與 FAQ）
當你的 OpenClaw 已在 Mac VPS 上 7×24 跑著 IM 通道，卻還要讓 Agent 自動開啟網頁、填表或抓取競品快照時，「在筆電上臨時開 Chrome」無法變成可審計的生產能力。OpenClaw 的 skill-browser 基於 Playwright 無頭 Chromium，把瀏覽動作接到 Gateway 工具面。本文面向僅 SSH、無桌面的 Mac 雲運維與平台負責人：先拆四條典型痛點，再給無頭 Mac VPS vs 本地有屏 Mac vs Docker browser 的決策矩陣，隨後給出前置清單、並行參數表、七步 Runbook、三條可引用判據、報錯對照表與業務實例；內鏈網關 install、Docker 7×24、版本釘扎與 ClawHub 審計文，幫助你在 Apple Silicon Mac 雲上完成可複現部署。
目錄
1. 痛點拆解：Chromium 缺失、OOM 與模態阻塞
skill-browser 把故障面擴展到瀏覽器子程序：Gateway 在線，首次 navigate 仍可能失敗。
- Chromium 未同帳戶安裝：CLI 與 launchd 使用者不一致，快取分裂，日誌報找不到可執行檔。
- Exit 137：並行 context 過高，Chromium 被 OOM Kill，Gateway 僅見 tool timeout。
- HOME 分裂：SSH 能冒煙、launchd 不能，設定目錄不可寫或 profile 鎖死。
- 模態阻塞：未配
blockedByDialog時 evaluate 掛起，返回空快照。
2. 決策矩陣：無頭 Mac VPS vs 本地 Mac vs Docker browser
開發除錯可用本地 Mac；7×24 與 18789 同機選無頭 Mac 雲。Docker 見7×24 Runbook。
| 維度 | 無頭 Mac VPS | 本地有屏 Mac | Docker 內 browser |
|---|---|---|---|
| 延遲 | 與 Gateway 同機，RTT 低，適合生產 | 開發友好，休眠斷鏈 | 網路卷權限多一層 |
| 磁碟 | Chromium 快取約 300–500 MB | 路徑難統一 | 重建重複下載 |
| 權限 | 純 headless，launchd 對齊 | 可手點模態 | 易 137 與反爬 |
| 運維 | 見網關 Runbook | 無法 7×24 | 排障鏈更長 |
| 場景 | 填表、快照、IM 聯動 | selector 除錯 | 短時批處理 |
3. Mac VPS 前置：Node 22、18789 與同帳戶 HOME
- 執行時：Node.js 22+；
openclaw doctor與openclaw --version無告警。 - 網關：
lsof -i :18789或openclaw gateway status監聽；失敗見網關 Runbook。 - 帳戶對齊：launchd plist 的
UserName與HOME須與 Chromium 安裝一致。 - 資源與審計：≥8 GB 記憶體、20 GB 磁碟；ClawHub 前完成Skill 審計。
openclaw gateway status
echo "USER=$USER HOME=$HOME"
4. skill-browser 參數表：headless、並行與逾時
skill-browser 基於 Playwright 無頭 Chromium。下表為評審骨架。
| 設定鍵 | 建議方向 | 常見誤配反例 |
|---|---|---|
headless |
無桌面設 true | false 找不到 display |
parallel contexts |
起步 1–2，每 context 約 400–600 MB | 4+ 易 OOM 137 |
timeout-ms |
navigate 3–6 萬 ms | 過短失敗，過長占佇列 |
blockedByDialog |
模態 dismiss 或 fail-fast | 未配 evaluate 掛死 |
npx puppeteer browsers install chromium
5. 七步 Runbook：帳戶 → 安裝 → Chromium → 探針 → 冒煙 → launchd
- 帳戶與 HOME 對齊：核對 plist
UserName；SSH 同使用者，echo $HOME一致。 - 版本釘扎與 doctor：備份
openclaw.json，openclaw doctor；升級見五月版本線 Runbook。 - 安裝 skill-browser：審計後
openclaw skills install skill-browser。 - 安裝 Chromium：同帳戶
npx puppeteer browsers install chromium。 - 寫參數：headless、parallel contexts、timeout-ms、blockedByDialog。
- 探針冒煙：18789 監聽，固定 URL 快照，記 toolCallId。
- launchd 驗收：launchctl 載入 plist，重啟後複跑冒煙。
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.openclaw.gateway.plist
openclaw doctor
openclaw gateway status
6. 三條可引用判據：冷啟動、RSS、快照成功率
- Chromium 冷啟動：Mac 雲首次 launch 宜低於 8 秒；超 15 秒先查磁碟 IO。
- 記憶體占用：單 context 冒煙後 RSS 宜低於可用記憶體 60%。
- 快照成功率：固定 URL 連跑 20 次 ≥95%；低於 90% 改模態策略。
7. 報錯對照表與分層排障
「browser 工具失敗」按層排查：Chromium 是否存在 → 同帳戶 HOME → headless/並行參數 → 模態與 timeout。每層對齊 JSONL toolCallId。
| 症狀 | 根因 | 修復 |
|---|---|---|
| 找不到 Chromium | 未裝或使用者不一致 | 同使用者重裝 browser + doctor |
| Exit 137 | 並行過高/OOM | 降 parallel contexts |
| blockedByDialog | 模態未處理 | dismiss 或 fail-fast |
| evaluate 逾時 | timeout 過短/反爬 | 調 timeout 或換 URL |
8. 業務實例：填表、監控與 IM 聯動
客服填表：Telegram 收工單，skill-browser 填表截圖；SSO 設 fail-fast。競品監控：cron 快照寫 JSONL，parallel 保持 1。瀏覽回覆：@bot 問文件，navigate 後摘要。
9. FAQ
問：能與 Ollama 或多 Provider 共存嗎？ 可以；在 tools.profile 設並發上限。
問：升級 v2026.5.x 後要重驗嗎？ 須 doctor、同帳戶重裝 Chromium；見版本線 Runbook。
問：Mac 雲 vs Linux/Docker？ 7×24 同機選 Mac 雲；短批處理可 Docker。
10. 結論
成功標準：skill-browser → 同帳戶 Chromium → 18789 快照可複現。租賃 VPSMAC Apple Silicon Mac 雲把 Gateway、Chromium 與 launchd 收進同一 Runbook；見Docker 7×24與Skill 審計。