自 OpenClaw v2026.5.3 版本起，插件体系经历了重大调整——所有官方插件均已解耦为独立外部模块，不再统一捆绑进主安装包。这意味着，如果你只需要 WhatsApp、Slack 或 Amazon Bedrock 中的某几项能力，就无需再忍受整个包体积臃肿、启动速度变慢、依赖冲突风险上升的困扰。不过，代价是必须手动触发安装方能加载，否则这些插件根本不会出现。

检查当前版本与核心运行状态

打开终端，首先执行 openclaw --version。输出结果必须至少为 【v2026.5.3】（更高版本如 v2026.5.12 亦可），低于此版本则无法使用外部化插件机制。

接着验证 Gateway 是否正常运行：openclaw gateway --status。正常情况下，它应监听在 ws://127.0.0.1:18789。若提示“command not found”，说明可能未全局安装或 PATH 环境变量未生效——请先执行 npm install -g openclaw@latest，再重启终端重试。

查看可用插件清单

执行 openclaw plugins list --a vailable，该命令会拉取最新插件仓库索引，列出所有支持外部安装的插件及其用途说明。需注意，列表中带有 [external] 标签的才属于本版本解耦范围；未标记的插件（如 @openclaw/core）依然内置于主程序中，无法卸载。

安装指定插件（三步法）

第一步：执行安装命令。例如，要接入 WhatsApp，输入 openclaw plugins install whatsapp。

第二步：安装过程会自动下载 Baileys SDK 及其兼容补丁，并写入 ~/.openclaw/plugins/whatsapp/ 目录。安装期间请勿中断终端，否则可能残留损坏的 node_modules，届时需要手动清理。

第三步：安装成功后，系统会提示“Plugin whatsapp installed. Requires restart.”——此时必须执行 openclaw gateway --restart，否则新插件不会被 Gateway 加载。

启用与配置插件

有两种方式启用插件：

方法一：命令行启用
执行 openclaw plugins enable whatsapp，该操作仅修改本地启用状态，不会触发重载。

方法二：配置文件启用
编辑 ~/.openclaw/openclaw.json，在 "plugins" 节点下添加 "whatsapp": true；保存后仍需重启 Gateway 才能生效。

⚠️ 特别提醒：部分插件（例如 bedrock）启用后会要求手动填入 AWS 凭据，路径为 ~/.openclaw/plugins/bedrock/config.json。填写错误的密钥格式会导致 Gateway 启动失败，且往往不会给出明确报错，排查起来相当棘手。

验证插件是否就绪

执行 openclaw plugins list --loaded，输出中应能看到 whatsapp (v2026.5.3) 或类似条目，状态显示为 active。

更进一步：向配对的 WhatsApp 账号发送一条测试消息，如果 OpenClaw 能正常接收并响应，则说明整个插件链路（Gateway → Plugin → Baileys → WhatsApp API）已完全打通。