问题描述
升级 OpenClaw 到 2026.4.21 后,飞书插件(feishu)的依赖 @larksuiteoapi/node-sdk 没有随升级一起安装,导致 Gateway 无法启动。
复现步骤
- 全新安装 OpenClaw 或从低版本升级到 2026.4.21
- 配置飞书插件并启用
- 运行
openclaw gateway start 或 openclaw doctor --fix,报错:
Error: Cannot find module "@larksuiteoapi/node-sdk"
Require stack:
- /opt/homebrew/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js
临时修复
cd /opt/homebrew/lib/node_modules/openclaw
npm install @larksuiteoapi/node-sdk --legacy-peer-deps
openclaw gateway restart
环境
- OpenClaw: 2026.4.21
- Node: v25.8.1
- macOS: Darwin 25.2.0 (arm64)
根因分析
- 飞书插件的依赖
@larksuiteoapi/[email protected] 没有被加入 bundledDependencies
- doctor 在 config 加载阶段就失败,修不到这里(比 v2026.4.21 的修复范围更早)
--legacy-peer-deps 的场景也没有被依赖解析覆盖
建议
- 将
@larksuiteoapi/node-sdk 加入飞书插件的 bundledDependencies
- 在飞书插件加载前增加前置依赖检查
问题描述
升级 OpenClaw 到 2026.4.21 后,飞书插件(feishu)的依赖
@larksuiteoapi/node-sdk没有随升级一起安装,导致 Gateway 无法启动。复现步骤
openclaw gateway start或openclaw doctor --fix,报错:临时修复
cd /opt/homebrew/lib/node_modules/openclaw npm install @larksuiteoapi/node-sdk --legacy-peer-deps openclaw gateway restart环境
根因分析
@larksuiteoapi/[email protected]没有被加入 bundledDependencies--legacy-peer-deps的场景也没有被依赖解析覆盖建议
@larksuiteoapi/node-sdk加入飞书插件的 bundledDependencies