2026 OpenClaw v2026.5.12 模組化安裝完全指南：
按需 WhatsApp/Slack/Bedrock 頻道外掛、Lean core 遷移與 openclaw plugins 驗收清單（按天租用 macOS 隔離試跑）
當您已自架 OpenClaw、升級至 v2026.5.12 後發現「Gateway 能起、WhatsApp/Slack 卻像沒裝過、doctor 報缺外掛而 channels 仍顯示 configured」，值班若仍用「全量 npm 包自帶一切頻道」的舊心智，常把 Lean core 外置外掛 誤判成 路由或模型鑑權故障。本文面向 開發者與維運：提供 三類痛點、全量 core 與按需外掛決策矩陣、七步落地、分診表、三條可引用數據、1～3 日按天租用 macOS 日程，並內鏈 安裝與部署指南、ClawPack/Git 外部外掛、v2026.5.7 發布驗收 與 SSH/VNC FAQ。
本文目錄
01. 三類痛點：升級後頻道「消失」、磁碟仍被未用 SDK 撐滿、pnpm/peer 安裝掃描
1）升級至 5.12 後 WhatsApp/Slack「像壞了」：發行說明將 WhatsApp、Slack、Amazon Bedrock、Anthropic Vertex 等 移出 core 執行時期依賴，改為 ClawHub/npm 外掛按需安裝。設定檔仍寫 channels.whatsapp，但未裝外掛時 Gateway 工具表缺少 inbound/outbound 處理器。Runbook 須把 「設定存在」 與 「外掛已裝且通過 runtime 掃描」 拆成兩道閘門。
2）磁碟與 CI 快取仍被從不用的頻道 SDK 撐滿：Lean core 目標是 只拉您實際使用的提供商與頻道。若 CI 仍 bake 舊「全部入內」全域層，節點會保留數百 MB 級 AWS/Baileys 等依賴；與 ClawPack 供應鏈 並行時，應以「已裝外掛清單 + manifest 雜湊」稽核，而非憑記憶。
3）pnpm 11、peer 依賴與安裝期安全掃描：5.12 強調 pnpm 11 支援、保留第三方 peer，且 掃描聚焦外掛自有 runtime 入口。常見誤操作是在 WARN 時反覆 npm install -g --force，弄亂 managed 外掛根；應優先 openclaw plugins 與 openclaw doctor，並對照 5.7 外掛發布與 update 路徑。
02. 全量 core vs 按需頻道外掛：v2026.5.12 決策矩陣
| 能力面（5.12） | 通過訊號 | 短租 macOS 證據 |
|---|---|---|
| WhatsApp 外掛 | plugins list 含 whatsapp 且 enabled；Baileys 自 registry 解析 | 前後 channels status --channel whatsapp JSON（去識別） |
| Slack 外掛 | 安裝後 Gateway 重啟；媒體下載不因畸形 redirect 失敗 | 對照 5.12 安全加固 scope 紀錄 |
| Bedrock / Vertex | 未裝外掛時 core 不拉 AWS SDK；裝後模型清單可見 provider | 磁碟 du 對比「僅 core」與「+Bedrock」 |
| Telegram 群組 allowlist | 單帳號下顯式空 groups: {} 不再靜默丟群訊息（5.12 修正） | 升級前後各抓一條群訊息探測日誌 |
| Node 執行環境 | Node 24 建議（或 ≥22.19） | node -v 寫入 Runbook 頁首 |
03. 七步落地：凍結 → 備份升級 → 按需 plugins install → channels 驗收 → Telegram → doctor → 證據
- 凍結基線：記錄
openclaw --version、plugins list、channels list --all與實際載入的openclaw.json路徑。 - 備份與升級：設定快照後升級至 v2026.5.12，保存 stdout 與結束碼。
- 僅為真實頻道安裝外掛：避免「全裝一遍」抵消 Lean core；每個外掛後必須 重啟 Gateway。
- channels 與 plugins 交叉驗收：configured/enabled 與 installed/enabled 一致。
- Telegram 群組策略回歸：單帳號曾寫顯式空
groups: {}時，驗證根級channels.telegram.groups。 - doctor 與磁碟預算：處理外掛 runtime 掃描 WARN；量測 managed 外掛根體積變化。
- 證據鏈與擦除：去識別保存安裝日誌；刪除租機 Bot token、Slack signing secret 與暫時 AWS 金鑰。
openclaw --version
openclaw plugins list 2>&1 | tee /tmp/oc512-plugins-before.txt
openclaw update
openclaw plugins install <plugin-id>
openclaw gateway restart
openclaw doctor 2>&1 | tee /tmp/oc512-doctor.txt磁碟剩餘低於 15 GB 時，並行「升級 + 多外掛 + 重啟」易觸發 pnpm 重試失敗。頻寬預期見 SSH/VNC 與成本 FAQ。
04. 分診表：症狀 → 優先動作 → 常見誤操作
| 症狀 | 優先動作 | 常見誤操作 |
|---|---|---|
| 設定有 slack，Gateway 無 Slack 工具 | 查 plugins list；補裝 Slack 外掛並重啟 | 改模型路由或 SecretRef 整晚 |
| install 被安全掃描拒絕 | 讀外掛入口路徑；確認 5.12 二進位 | 全域 --force 破壞 managed 根 |
| Telegram 群升級後全靜默 | 核對單帳號空 groups: {} 語意 | 盲目 groupPolicy: open 擴暴露面 |
05. 三條可引用數據、誤區與 1～3 日租用日程
- 數據 1：GitHub 發行 v2026.5.12 於 2026-05-14 釋出，文件化 WhatsApp/Slack/Bedrock/Vertex 外置。
- 數據 2：文件建議 Node 24；M4 租機上 CLI + Control UI 驗收常可壓在 2～4 小時 集中視窗。
- 數據 3：單一或雙頻道環境相對舊 full core，依賴樹常見 30～55% 縮小（視歷史安裝而定）。
第 1 日：基線 + 升級 + 一個外掛。第 2 日：第二頻道或 Bedrock + Telegram 探測。第 3 日：回滾演練與秘密擦除。
06. 純 Linux 無頭節點 vs 按天租 Mac
VPS 適合 Gateway 常駐，但把外掛日誌、瀏覽器 ClawHub 文件與 Keychain 部署金鑰拆到不同機器，隱性成本會被低估。短時間原生 macOS 租用可讓 plugins list、channels status 與 Control UI 落在同一證據鏈，再上線前留下 Runbook。
容器與 SSH 適合 短期驗證；若要在 1～3 日 內交出可交接 Runbook，按天租 Mac 通常在維運時間上更划算。請見 Mac mini M4 價格指南 與 FAQ。雖可用 Linux 完成試跑，但 GUI 與 CLI 跨機對照會留下協調負債；重視 Apple 桌面鄰近再現性的團隊，短期原生 macOS 通常能減少返工。