Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug] 飞书插件升级后依赖漏装导致 Gateway 无法启动 (v2026.4.21) [2 pull requests, 7 comments, 7 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#70025•Fetched 2026-04-23 07:30:16
View on GitHub
Comments
7
Participants
7
Timeline
14
Reactions
2
Author
liumengdi666liumengdi666
Participants
CharyeahOwOCharyeahOwOgmvp3gmvp3hayibanhayibanliumengdi666liumengdi666rafiki270rafiki270shakeshakesteipetesteipete
Timeline (top)
commented ×7cross-referenced ×3subscribed ×2closed ×1

Error Message

Error: Cannot find module "@larksuiteoapi/node-sdk" Require stack:

  • /opt/homebrew/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js

Fix Action

Fixed

PR fix notes

PR #70095: fix(feishu): add @larksuiteoapi/node-sdk to bundledDependencies (#70025)

Description (problem / solution / changelog)

Fixes #70025 — Feishu plugin missing @larksuiteoapi/node-sdk from bundledDependencies, causing 'module not found' at gateway startup for fresh installs.

Changed files

  • extensions/browser/src/browser/pw-session.test.ts (modified, +75/-0)
  • extensions/browser/src/browser/pw-session.ts (modified, +65/-0)
  • extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts (modified, +1/-0)
  • extensions/browser/src/browser/pw-tools-core.snapshot.ts (modified, +10/-1)
  • extensions/feishu/package.json (modified, +3/-0)
  • extensions/telegram/package.json (modified, +1/-1)
  • extensions/telegram/src/bot-message-context.body.ts (modified, +10/-1)
  • extensions/whatsapp/src/auto-reply.web-auto-reply.last-route.test.ts (modified, +109/-0)
  • extensions/whatsapp/src/auto-reply/monitor/on-message.ts (modified, +6/-0)
  • src/agents/pi-embedded-subscribe.subscribe-embedded-pi-session.custom-provider-payloads.test.ts (added, +113/-0)
  • src/agents/pi-embedded-subscribe.ts (modified, +5/-3)
  • src/agents/sandbox/remote-fs-bridge.test.ts (modified, +57/-0)
  • src/agents/sandbox/remote-fs-bridge.ts (modified, +16/-2)
  • src/infra/system-events.test.ts (modified, +31/-0)
  • src/infra/system-events.ts (modified, +6/-1)
  • src/plugins/bundled-capability-runtime.ts (modified, +1/-1)
  • src/plugins/bundled-channel-config-metadata.ts (modified, +1/-1)
  • src/plugins/loader.ts (modified, +1/-1)
  • src/plugins/public-surface-loader.ts (modified, +2/-2)
  • src/plugins/source-loader.ts (modified, +1/-1)
  • src/process/supervisor/supervisor.ts (modified, +1/-1)
  • src/tasks/task-registry.audit.test.ts (modified, +77/-0)
  • src/tasks/task-registry.ts (modified, +7/-4)

PR #69893: fix: multiple bundled plugin and channel regression fixes

Description (problem / solution / changelog)

Multiple regression fixes for bundled plugins and channel plugins.

Fixes included:

  • #69793: Telegram photo inbound media type classification
  • #69783: Bun global install hang (jitiFilename modulePath fix)
  • #69831: Telegram grammy version mismatch (staging skip + bundledDependencies)
  • #70025: Feishu @larksuiteoapi/node-sdk missing bundledDependencies
  • #70026: SIGTERM instead of SIGKILL for supervisor cleanup
  • #69478: Deduplicate enqueued system events
  • #69229: Task createdAt/startAt timestamp clamping
  • #69410: AssistantTexts populated at message_end
  • #69369: Docker binds in RemoteShellSandboxFsBridge
  • #69289: Resolve ax refs in browser actions

Changed files

  • extensions/browser/src/browser/pw-session.test.ts (modified, +75/-0)
  • extensions/browser/src/browser/pw-session.ts (modified, +65/-0)
  • extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts (modified, +1/-0)
  • extensions/browser/src/browser/pw-tools-core.snapshot.ts (modified, +10/-1)
  • extensions/feishu/package.json (modified, +3/-0)
  • extensions/telegram/package.json (modified, +4/-1)
  • extensions/telegram/src/bot-message-context.body.ts (modified, +10/-1)
  • extensions/whatsapp/src/auto-reply.web-auto-reply.last-route.test.ts (modified, +109/-0)
  • extensions/whatsapp/src/auto-reply/monitor/on-message.ts (modified, +6/-0)
  • src/agents/pi-embedded-subscribe.subscribe-embedded-pi-session.custom-provider-payloads.test.ts (added, +113/-0)
  • src/agents/pi-embedded-subscribe.ts (modified, +5/-3)
  • src/agents/sandbox/remote-fs-bridge.test.ts (modified, +57/-0)
  • src/agents/sandbox/remote-fs-bridge.ts (modified, +16/-2)
  • src/infra/system-events.test.ts (modified, +31/-0)
  • src/infra/system-events.ts (modified, +6/-1)
  • src/plugins/bundled-capability-runtime.ts (modified, +1/-1)
  • src/plugins/bundled-channel-config-metadata.ts (modified, +1/-1)
  • src/plugins/loader.ts (modified, +1/-1)
  • src/plugins/public-surface-loader.ts (modified, +2/-2)
  • src/plugins/source-loader.ts (modified, +1/-1)
  • src/process/supervisor/supervisor.ts (modified, +1/-1)
  • src/tasks/task-registry.audit.test.ts (modified, +77/-0)
  • src/tasks/task-registry.ts (modified, +7/-4)

Code Example

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
RAW_BUFFERClick to expand / collapse

问题描述

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

复现步骤

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

根因分析

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

建议

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

extent analysis

TL;DR

Manually installing the missing @larksuiteoapi/node-sdk dependency using npm install @larksuiteoapi/node-sdk --legacy-peer-deps can temporarily resolve the issue.

Guidance

  • The error occurs because the @larksuiteoapi/node-sdk dependency is not included in the bundled dependencies of the Feishu plugin, causing the Gateway to fail to start.
  • To verify the issue, check the error message for the missing module and the require stack, which points to the Feishu client file.
  • As a temporary fix, run the provided command npm install @larksuiteoapi/node-sdk --legacy-peer-deps in the OpenClaw directory, followed by openclaw gateway restart.
  • Consider adding @larksuiteoapi/node-sdk to the bundled dependencies of the Feishu plugin to prevent similar issues in the future.

Example

No code snippet is necessary, as the issue provides a clear command to resolve the problem.

Notes

This solution assumes that the issue is specific to the Feishu plugin and the missing @larksuiteoapi/node-sdk dependency. If the issue persists or occurs with other plugins, further investigation may be necessary.

Recommendation

Apply the temporary workaround by running npm install @larksuiteoapi/node-sdk --legacy-peer-deps and restarting the Gateway, as this is a straightforward and effective solution to resolve the immediate issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#chain error#conversation history#tool integration#LLM response

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix [Bug] 飞书插件升级后依赖漏装导致 Gateway 无法启动 (v2026.4.21) [2 pull requests, 7 comments, 7 participants]