Skip to content

[Bug] 飞书插件升级后依赖漏装导致 Gateway 无法启动 (v2026.4.21) #70025

Description

@liumengdi666

问题描述

升级 OpenClaw 到 2026.4.21 后,飞书插件(feishu)的依赖 @larksuiteoapi/node-sdk 没有随升级一起安装,导致 Gateway 无法启动。

复现步骤

  1. 全新安装 OpenClaw 或从低版本升级到 2026.4.21
  2. 配置飞书插件并启用
  3. 运行 openclaw gateway startopenclaw 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)

根因分析

  1. 飞书插件的依赖 @larksuiteoapi/[email protected] 没有被加入 bundledDependencies
  2. doctor 在 config 加载阶段就失败,修不到这里(比 v2026.4.21 的修复范围更早)
  3. --legacy-peer-deps 的场景也没有被依赖解析覆盖

建议

  • @larksuiteoapi/node-sdk 加入飞书插件的 bundledDependencies
  • 在飞书插件加载前增加前置依赖检查

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions