openclaw - ✅(Solved) Fix [Bug]: Windows fresh install — setup wizard crashes with Cannot find module '@larksuiteoapi/node-sdk' even when Feishu is never enabled [1 pull requests, 6 comments, 6 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#70346Fetched 2026-04-23 07:25:58
View on GitHub
Comments
6
Participants
6
Timeline
14
Reactions
3
Author
Timeline (top)
commented ×6cross-referenced ×3labeled ×2subscribed ×2

Windows setup wizard crashes due to missing feishu dependency

Error Message

<br>Error: Cannot find module '@larksuiteoapi/node-sdk'<br>Require stack:<br>- C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\dist\extensions\feishu\client-yWGpoGkZ.js<br>

Root Cause

Windows setup wizard crashes due to missing feishu dependency

Fix Action

Fix / Workaround

<br>Affected: All Windows users doing fresh install<br>Severity: High (blocks setup wizard completely)<br>Frequency: 100% (every fresh install)<br>Consequence: Cannot complete OpenClaw installation without manual workaround<br>

PR fix notes

PR #70339: fix(feishu): lazy-load setup client to avoid missing staged runtime deps during onboard

Description (problem / solution / changelog)

Summary

This fixes onboarding failures where Feishu setup paths eagerly loaded @larksuiteoapi/node-sdk before staged runtime dependencies were installed.

The fix makes Feishu client loading lazy in setup/tool-registration code paths, so openclaw onboard can load plugin setup surfaces without requiring Feishu runtime deps up front.

Fixes #70338, #70346, #70343

Root Cause

onboard loads bundled setup entries, which pulled Feishu modules with static imports of ./client.js, which in turn statically imported @larksuiteoapi/node-sdk.
Because this dependency is staged runtime-owned, it may not exist yet at setup-load time.

What Changed

  • Converted setup-path client acquisition to dynamic import / async flow across Feishu tool modules.
  • Updated callers to await async client getters.
  • Kept runtime behavior unchanged once clients are actually used.

Validation

  • pnpm tsgo:prod passed.
  • pnpm openclaw onboard --help now starts successfully without module-load failure.
  • Repro before: Cannot find module '@larksuiteoapi/node-sdk' in onboard setup load path.

Changed files

  • extensions/feishu/src/bitable.ts (modified, +9/-9)
  • extensions/feishu/src/chat.ts (modified, +5/-3)
  • extensions/feishu/src/comment-reaction.ts (modified, +2/-1)
  • extensions/feishu/src/docx.ts (modified, +3/-3)
  • extensions/feishu/src/drive.ts (modified, +1/-1)
  • extensions/feishu/src/perm.ts (modified, +1/-1)
  • extensions/feishu/src/tool-account.ts (modified, +3/-3)
  • extensions/feishu/src/wiki.ts (modified, +1/-1)

Code Example

<br>Error: Cannot find module '@larksuiteoapi/node-sdk'<br>Require stack:<br>- C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\dist\extensions\feishu\client-yWGpoGkZ.js<br>
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Windows setup wizard crashes due to missing feishu dependency

Steps to reproduce

  1. Run npm uninstall -g openclaw to remove any existing installation
  2. Delete ~/.openclaw config directory completely
  3. Run iwr -useb https://openclaw.ai/install.ps1 | iex to install fresh
  4. When setup starts, select "Reset" (full reset) for config handling
  5. Select "QuickStart" mode
  6. Select "Ollama" as model provider
  7. Accept default Ollama settings (http://127.0.0.1:11434)
  8. Select any default model (e.g., ollama/glm-4.7-flash:latest)
  9. Crash occurs with "Cannot find module '@larksuiteoapi/node-sdk'"

Expected behavior

Setup wizard should complete successfully on a fresh install without requiring manual installation of dependencies for unused plugins.

Actual behavior

Setup wizard crashes at "Default model" step with error: Error: Cannot find module '@larksuiteoapi/node-sdk' Require stack:

  • C:\Users...\openclaw\dist\extensions\feishu\client-yWGpoGkZ.js

OpenClaw version

2026.4.21 (f788c88)

Operating system

Windows 11

Install method

npm global (via install.ps1)

Model

ollama/glm-4.7-flash:latest

Provider / routing chain

openclaw -> ollama

Additional provider/model setup details

Local Ollama instance at http://127.0.0.1:11434/

Logs, screenshots, and evidence

<br>Error: Cannot find module '@larksuiteoapi/node-sdk'<br>Require stack:<br>- C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\dist\extensions\feishu\client-yWGpoGkZ.js<br>

Impact and severity

<br>Affected: All Windows users doing fresh install<br>Severity: High (blocks setup wizard completely)<br>Frequency: 100% (every fresh install)<br>Consequence: Cannot complete OpenClaw installation without manual workaround<br>

Additional information

Related issues: #69923, #63129 This report specifically covers Windows native fresh install scenario.

extent analysis

TL;DR

The most likely fix is to ensure the @larksuiteoapi/node-sdk dependency is properly installed or bundled with the OpenClaw installation package.

Guidance

  • Verify that the @larksuiteoapi/node-sdk package is included in the OpenClaw installation package or is installed as a dependency during the installation process.
  • Check the install.ps1 script to ensure it installs all required dependencies, including @larksuiteoapi/node-sdk, for the OpenClaw setup wizard to complete successfully.
  • Consider adding a check in the setup wizard to handle cases where the @larksuiteoapi/node-sdk dependency is missing, providing a clear error message or automatically installing the dependency if possible.
  • Review related issues #69923 and #63129 for potential insights or fixes that may apply to this scenario.

Example

No specific code snippet is provided due to the lack of detailed implementation details in the issue report.

Notes

The provided information suggests a dependency issue specific to the Windows installation process of OpenClaw. Ensuring that all dependencies, including @larksuiteoapi/node-sdk, are properly installed or bundled with the installation package should resolve the issue. However, without access to the specific implementation details of the install.ps1 script or the OpenClaw setup wizard, the exact steps to fix the issue cannot be fully determined.

Recommendation

Apply a workaround by manually installing the @larksuiteoapi/node-sdk dependency before running the OpenClaw setup wizard, or modify the installation script to include this dependency, as it seems to be required for the setup wizard to complete successfully on Windows.

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…

FAQ

Expected behavior

Setup wizard should complete successfully on a fresh install without requiring manual installation of dependencies for unused plugins.

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]: Windows fresh install — setup wizard crashes with Cannot find module '@larksuiteoapi/node-sdk' even when Feishu is never enabled [1 pull requests, 6 comments, 6 participants]