插件加载问题

编号格式 #NNNNN 对应 GitHub issue，可直接搜索去重。

---

微信插件 2026.3.22+ 报 Cannot find module 'openclaw/plugin-sdk'

来源：GitHub #52885（2026-03）

现象：升级到 OpenClaw 2026.3.22 或更高版本后，微信插件 @tencent-weixin/openclaw-weixin 加载失败：

Error: Cannot find module 'openclaw/plugin-sdk'
Require stack:
- ~/.openclaw/extensions/openclaw-weixin/index.ts

原因：2026.3.22 改变了插件模块路径的解析逻辑，外部插件对 openclaw/plugin-sdk 的 import 无法再通过 jiti 在全局安装目录找到模块。影响所有基于旧版 SDK 写法的第三方插件。

解决方法：

在插件目录下重新安装依赖，让 node_modules 包含局部副本：

cd ~/.openclaw/extensions/openclaw-weixin
npm install
openclaw gateway restart

验证：检查插件目录下是否生成了 node_modules/openclaw 目录。同样适用于其他第三方插件遇到此问题时。

---

WhatsApp 渠道在 2026.3.22 ~ 2026.3.23-1 完全无法启动

来源：GitHub #53216 / #53244 / #53285（2026-03）

现象：升级到 2026.3.22 或 2026.3.23-1 后，WhatsApp 渠道启动失败，报以下错误之一：

# 2026.3.22 报：
[gateway/channels] channel startup failed; cannot find module 'light-runtime-api.js'

# 2026.3.23-1 报：
Error: Cannot find module '@whiskeysockets/baileys'

原因：

• 2026.3.22：npm 包发布时遗漏了 dist/extensions/whatsapp/ 下的 TypeScript 源文件
• 2026.3.23-1：修复了源文件缺失，但 @whiskeysockets/baileys 依赖未打包进 npm 发布物

这是 2026.3.22 ~ 2026.3.23-1 版本的打包问题，2026.3.23-2 起已修复。

解决方法：

方案 1（推荐）：升级到 2026.3.23-2 或更新版本：

npm install -g openclaw@latest

方案 2：降级到最后稳定版本：

npm install -g openclaw@2026.3.13

方案 3：如仍使用 2026.3.23-1，手动补装缺失依赖：

cd $(npm root -g)/openclaw/dist/extensions/whatsapp
npm install @whiskeysockets/baileys

---

另见

• WhatsApp 渠道问题
• ← 安装问题总览