模块化服务器机柜与线缆，象征 OpenClaw 按需频道插件安装

2026 OpenClaw v2026.5.12 模块化安装完全指南：
按需安装 WhatsApp/Slack/Bedrock 频道插件、核心瘦身迁移与 openclaw plugins 验收排错清单（含按天租用 macOS 隔离试跑）

当你已自托管 OpenClaw、升级到 v2026.5.12 后发现「Gateway 能起、WhatsApp/Slack 却像没装过、doctor 报缺插件而 channels 仍显示 configured」，值班主任若仍按「全量 npm 包自带一切频道」的旧心智会把Leaner installs 外置插件误判成路由或模型鉴权坏了。本文面向开发者与运维：给出三类痛点 + 全量 core 与按需插件决策矩阵 + 七步落地 + 分诊表 + 三条可引用数据 + 1～3 日按天租用 macOS 日程，并内链 安装与部署指南、ClawPack/Git 外部插件、v2026.5.7 发布验收、v2026.5.5 频道与 npm 与 SSH/VNC FAQ。

01. 三类痛点：升级后频道「消失」、磁盘仍被未用 SDK 撑满、pnpm/peer 安装被扫描阻断

1）升级到 5.12 后 WhatsApp/Slack「像坏了」：发行说明把 WhatsApp、Slack、Amazon Bedrock、Anthropic Vertex 等移出 core 运行时依赖锥，改为 ClawHub/npm 插件按需安装。配置里仍写着 channels.whatsapp 或 channels.slack，但 Gateway 工具表里没有对应 inbound/outbound，IM 侧就会表现为「连上但不回」或启动期 WARN。这不是模型路由问题，而是插件未安装或未 enabled——Runbook 必须把「配置存在」与「插件已装且通过 runtime 扫描」拆成两道闸门。

2）磁盘与 CI 缓存仍被「从不用的频道 SDK」撑满：Leaner installs 的目标是让只拉你用到的提供商与频道。团队若仍在镜像里 bake 全量 openclaw@latest 旧层，会在节点上保留数百 MB 级 AWS/Baileys 等依赖；与 ClawPack 外部插件供应链 并行时，更要以「已装插件列表 + 依赖 manifest 哈希」做审计，而不是凭主观「我记得装过 Slack」。

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 决策矩阵

下表面向30 秒内可执行的验收语义：左列是你关心的频道/提供商，中列是 5.12 后「通过信号」，右列是短租 macOS 上建议留存的证据。

能力面（5.12） 通过信号 短租 macOS 证据
WhatsApp（外置插件） plugins list 含 whatsapp 且 enabled；Baileys 7.0.0-rc11 从 registry 解析 保存安装前后 openclaw 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）；与 install.sh 一致 node -v 写入 Runbook 页眉

与 v2026.5.5 频道与 npm 自愈 相邻：5.12 把「频道依赖」从 core 剥离后，npm 官方插件同步仍可能发生，但未装插件 = 无工具注册是硬规则；与 多平台安装指南 相邻：新装应默认走「core + 按需 plugins」，而不是假设一条 npm i -g 自带 WhatsApp。

03. 七步落地：冻结 → 备份升级 → 按需 plugins install → channels 验收 → Telegram 群组策略 → doctor → 证据归档

  1. 冻结基线：记录 openclaw --version、openclaw plugins list、openclaw channels list --all；确认实际加载的 openclaw.json 路径与 Gateway 启动参数。
  2. 备份与升级：按发行说明在升级前快照配置；执行 openclaw update 或等价渠道到 v2026.5.12，保存 stdout 与退出码。若从 git 源安装，注意 --no-git-update 与 lockfile 行为变更。
  3. 仅为真实频道安装插件：例如仅企业用 Slack 则只装 Slack 插件，避免「全装一遍」抵消 Leaner installs。安装后必须重启 Gateway 并复查工具注册表。
  4. channels 与 plugins 交叉验收：channels status 的 configured/enabled 与 plugins list 的 installed/enabled 一致；勿再用「channels 列表有名字」代替「插件已装」。
  5. Telegram 群组策略回归：若使用单账号且曾写显式空 groups: {}，升级后验证根级 channels.telegram.groups allowlist 是否恢复生效；多账号场景仍可用 per-account 显式禁用。
  6. doctor 与磁盘预算：跑 openclaw doctor，处理插件 runtime 扫描 WARN；对比升级前后全局 node_modules 或 managed 插件根体积，目标常可节省数百 MB 级未用 SDK（视历史安装而定）。
  7. 证据链与擦除：脱敏保存 plugins 安装日志；在按天租用机上删除演示 Bot token、Slack signing secret 与临时 AWS 密钥；按 Runbook 卸载，避免半卸载导致工具表脏读。
# 冻结与按需安装示例（插件 ID 以 openclaw plugins search 为准）
openclaw --version
openclaw plugins list 2>&1 | tee /tmp/oc512-plugins-before.txt
openclaw backup create   # 若环境已启用 backup 子命令

openclaw update          # 或你的 stable 通道命令
openclaw plugins install <whatsapp-plugin-id>   # 仅当需要 WhatsApp
openclaw gateway restart

openclaw plugins list
openclaw channels status --json | head -c 6000
openclaw doctor 2>&1 | tee /tmp/oc512-doctor.txt

磁盘剩余低于 15 GB 时，并行「升级 + 多插件安装 + Gateway 重启」易触发 pnpm 重试失败；应先清理缓存。连接与带宽预期见 SSH/VNC 与成本 FAQ。

04. 分诊表：症状 → 优先动作 → 常见误操作

症状 优先动作 常见误操作
配置有 slack，Gateway 无 Slack 工具 查 plugins list 是否 installed+enabled；补装 Slack 插件并重启 改模型路由或 SecretRef，浪费一整晚
plugins install 被安全扫描拒绝 读扫描指向的插件入口而非整个 node_modules；升级 5.12 后再试 全局 --force 破坏 managed 根
Telegram 群升级后全静默 核对单账号空 groups: {} 语义；对照根级 groups allowlist 盲目 groupPolicy: open 扩大暴露面
Bedrock 模型列表空 确认 Bedrock 插件已装；检查 IAM/region 与 SecretRef 在 core 里找已移除的 AWS SDK 路径

05. 三条可引用数据、误区与 1～3 日按天租用 macOS 日程

  • 数据 1：GitHub Release v2026.5.12 发布于 2026-05-14， Highlights 明确列出 WhatsApp/Slack/Bedrock/Vertex externalize 与 Telegram 轮询隔离、pnpm 11 等条目，可作为变更审计锚点。
  • 数据 2：官方安装文档推荐 Node 24（或 Node 22.19+）；在 M4 按天租用节点上，完整 Xcode 非必需，但原生 macOS + 钥匙串 + Control UI 可把 plugins 验收时间从「跨机复制日志」压缩到单会话 2～4 小时量级（团队样本）。
  • 数据 3：对仅使用 1～2 个频道的自托管实例，按需插件策略常使全局依赖目录体积下降约 30%～55%（相对历史全量 core，视曾启用提供商而定）；应用商店侧无直接收益，但 CI 镜像与租机磁盘显著受益。

误区 A：认为 npm install -g openclaw@latest 仍自带 WhatsApp。误区 B：未重启 Gateway 就判定插件安装失败。误区 C：把 Telegram 群静默与 Slack 插件缺失混查，未分诊。

第 1 日：冻结 plugins/channels 基线，升级 5.12，保存 doctor；傍晚只装一个最急需频道插件并验收。

第 2 日：补装第二频道或 Bedrock；做 Telegram 群组探测；记录磁盘差值。

第 3 日：回滚演练、擦除租机密钥、输出 Runbook 与生产切换窗口。

06. 纯 Linux 无头节点 vs 按天租 Mac：plugins 证据链与 Control UI

Linux VPS 跑 Gateway 成本低，但plugins 安装日志、浏览器里对照 ClawHub 文档、以及钥匙串中的只读 deploy key分散在三台机器时，排错隐性成本会超过租机费用。短租原生 macOS 让你把plugins list、channels status、doctor与 Control UI 放在同一证据链，再决定是否切生产。

虽然你可以用纯 Docker 卷 + SSH完成大部分 CLI 验收，但容器更适合短期验证：当你要在 1～3 天内把「按需插件 + 频道恢复」写成可交接 Runbook，并与团队主力机解耦，按天租用 Mac通常更顺畅。套餐对比见 套餐价格页；连接方式见 SSH/VNC FAQ。