Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix [Bug]: install script doesn't ship optional extension deps; onboard crashes per-extension [1 comments, 2 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#69900•Fetched 2026-04-22 07:46:50
View on GitHub
Comments
1
Participants
2
Timeline
8
Reactions
3
Author
calebsbrandcalebsbrand
Participants
calebsbrandcalebsbrandsteipetesteipete
Timeline (top)
subscribed ×3labeled ×2closed ×1commented ×1

Fresh install of 2026.4.20 + openclaw onboard crashes sequentially on missing optional extension deps (feishu, nostr, slack, whatsapp, and 3 more). Each crash exits the wizard and requires a manual npm install --legacy-peer-deps <pkg> inside /opt/homebrew/lib/node_modules/openclaw before it can continue. Seven total missing modules on my run.

Error Message

  1. Wizard crashes: Error: Cannot find module '@larksuiteoapi/node-sdk'.

Root Cause

Fresh install of 2026.4.20 + openclaw onboard crashes sequentially on missing optional extension deps (feishu, nostr, slack, whatsapp, and 3 more). Each crash exits the wizard and requires a manual npm install --legacy-peer-deps <pkg> inside /opt/homebrew/lib/node_modules/openclaw before it can continue. Seven total missing modules on my run.

RAW_BUFFERClick to expand / collapse

Bug type

Crash (process/app exits or hangs)

Beta release blocker

No

Summary

Fresh install of 2026.4.20 + openclaw onboard crashes sequentially on missing optional extension deps (feishu, nostr, slack, whatsapp, and 3 more). Each crash exits the wizard and requires a manual npm install --legacy-peer-deps <pkg> inside /opt/homebrew/lib/node_modules/openclaw before it can continue. Seven total missing modules on my run.

Steps to reproduce

  1. Clean macOS 15, Homebrew + Node 20 installed.
  2. Run curl -fsSL https://openclaw.ai/install.sh | bash.
  3. Run openclaw onboard.
  4. Wizard crashes: Error: Cannot find module '@larksuiteoapi/node-sdk'.
  5. cd /opt/homebrew/lib/node_modules/openclaw && npm install --legacy-peer-deps @larksuiteoapi/node-sdk.
  6. Rerun openclaw onboard.
  7. Wizard crashes on next missing module (in my run: nostr-tools, then @slack/web-api, then @whiskeysockets/baileys, etc).
  8. Repeat steps 5-7 approximately seven times before onboard completes.

Expected behavior

install.sh completes and openclaw onboard runs through to completion without requiring manual npm installs for optional extension dependencies.

Actual behavior

openclaw onboard crashes sequentially with Cannot find module '<pkg>' errors for optional extension deps. Each crash exits the wizard. Plain npm install <pkg> also fails due to an internal [email protected] vs typescript peer-dep conflict — must use --legacy-peer-deps. Seven separate modules (feishu, nostr, slack, whatsapp, and more) had to be installed manually in /opt/homebrew/lib/node_modules/openclaw before onboard completed on my run.

OpenClaw version

2026.4.20 (115f05d)

Operating system

macOS 15.x on Apple Silicon (M4 Pro)

Install method

curl -fsSL https://openclaw.ai/install.sh | bash (npm global)

Model

N/A — install-time failure, no model involved

Provider / routing chain

N/A — install-time failure

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

extent analysis

TL;DR

The most likely fix is to modify the install.sh script to include npm install --legacy-peer-deps for all optional extension dependencies.

Guidance

  • The issue is caused by missing optional extension dependencies, which can be resolved by installing them manually using npm install --legacy-peer-deps.
  • To verify, check if all required dependencies are installed by running npm ls in the /opt/homebrew/lib/node_modules/openclaw directory.
  • Consider modifying the install.sh script to include the installation of all optional extension dependencies to prevent future crashes.
  • Identify all missing modules (feishu, nostr, slack, whatsapp, etc.) and create a single npm install command to install them all at once.

Example

npm install --legacy-peer-deps @larksuiteoapi/node-sdk nostr-tools @slack/web-api @whiskeysockets/baileys

Replace the package names with the actual missing modules.

Notes

This solution assumes that the install.sh script has the necessary permissions to install dependencies. Additionally, the use of --legacy-peer-deps may have implications for the project's dependency management and should be reviewed.

Recommendation

Apply workaround: Modify the install.sh script to include the installation of all optional extension dependencies using npm install --legacy-peer-deps. This will prevent the openclaw onboard wizard from crashing due to missing dependencies.

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

install.sh completes and openclaw onboard runs through to completion without requiring manual npm installs for optional extension dependencies.

#api#SSR setup#ISR setup#authentication setup#request error

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 - 💡(How to fix) Fix [Bug]: install script doesn't ship optional extension deps; onboard crashes per-extension [1 comments, 2 participants]