openclaw - 💡(How to fix) Fix 2026.4.20-beta.2 on WSL Ubuntu 22.04: bundled extension runtime deps missing after install/onboard, doctor --fix reports complete [2 comments, 3 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#69897Fetched 2026-04-22 07:46:53
View on GitHub
Comments
2
Participants
3
Timeline
5
Reactions
0
Timeline (top)
commented ×2closed ×1cross-referenced ×1labeled ×1

On WSL Ubuntu 22.04, a fresh install of OpenClaw 2026.4.20-beta.2 left bundled extension runtime dependencies missing.

openclaw doctor --fix reported Doctor complete., but openclaw onboard still failed with missing-module errors from bundled extensions, for example:

  • Cannot find module '@larksuiteoapi/node-sdk'
  • Cannot find module 'nostr-tools'

The only way to get it working was to manually install all dependencies declared by dist/extensions/*/package.json into the installed OpenClaw package root.


Error Message

Error: Cannot find module '@larksuiteoapi/node-sdk' Require stack: /home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js

Root Cause

This appears to be caused by one or more of the following:

Fix Action

Fix / Workaround

Workaround That Fixed It

Code Example

~/.npm-global/lib/node_modules/openclaw

---

openclaw gateway uninstall
npm uninstall -g openclaw
curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --version 2026.4.20-beta.2
~/.openclaw/bin/openclaw gateway install --force
~/.openclaw/bin/openclaw gateway restart

---

openclaw doctor --fix
openclaw onboard

---

Error: Cannot find module '@larksuiteoapi/node-sdk'
Require stack:
/home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js

---

Error: Cannot find module 'nostr-tools'
Require stack:
/home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/nostr/setup-surface-d0cfZ0y8.js

---

Error: unsafe dist entry: dist/extensions/microsoft/node_modules/.bin/node-edge-tts

---

Doctor complete.

---

cd ~/.openclaw/lib/node_modules/openclaw && npm install --omit=dev --no-save --package-lock=false --ignore-scripts --legacy-peer-deps $(node -e 'const fs=require("fs"),path=require("path");const root=path.join(process.cwd(),"dist","extensions");const seen=new Map();for(const entry of fs.readdirSync(root,{withFileTypes:true})){if(!entry.isDirectory())continue;const pkgPath=path.join(root,entry.name,"package.json");if(!fs.existsSync(pkgPath))continue;const pkg=JSON.parse(fs.readFileSync(pkgPath,"utf8"));for(const [name,version] of Object.entries(pkg.dependencies||{})){if(!seen.has(name))seen.set(name,name+"@"+version);}}process.stdout.write([...seen.values()].join(" "));')

---

~/.openclaw/bin/openclaw gateway restart
~/.openclaw/bin/openclaw onboard

---
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Summary

On WSL Ubuntu 22.04, a fresh install of OpenClaw 2026.4.20-beta.2 left bundled extension runtime dependencies missing.

openclaw doctor --fix reported Doctor complete., but openclaw onboard still failed with missing-module errors from bundled extensions, for example:

  • Cannot find module '@larksuiteoapi/node-sdk'
  • Cannot find module 'nostr-tools'

The only way to get it working was to manually install all dependencies declared by dist/extensions/*/package.json into the installed OpenClaw package root.


Environment

  • OpenClaw: 2026.4.20-beta.2 (4e25479)
  • OS: WSL Ubuntu 22.04
  • Node: v22.22.2

Install Methods Tested

1) Initial Install Path

  • Installer script
  • Service path ended up under:
    ~/.npm-global/lib/node_modules/openclaw

2) Clean Reinstall

Performed a full clean reinstall to the local-prefix install path:

openclaw gateway uninstall
npm uninstall -g openclaw
curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --version 2026.4.20-beta.2
~/.openclaw/bin/openclaw gateway install --force
~/.openclaw/bin/openclaw gateway restart

The reinstall still exhibited the same missing bundled runtime dependencies during onboarding.


Expected Behavior

A fresh install followed by:

openclaw doctor --fix
openclaw onboard

should work without requiring any manual npm install operations inside the OpenClaw package directory.


Actual Behavior

openclaw onboard failed with errors such as:

Error: Cannot find module '@larksuiteoapi/node-sdk'
Require stack:
/home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js

After manually installing that package, onboarding failed again:

Error: Cannot find module 'nostr-tools'
Require stack:
/home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/nostr/setup-surface-d0cfZ0y8.js

This indicates the issue is not specific to Feishu, but rather a broader bundled runtime dependency problem.

Additionally, on the older ~/.npm-global install, running the postinstall repair script failed with:

Error: unsafe dist entry: dist/extensions/microsoft/node_modules/.bin/node-edge-tts

What doctor --fix Did

openclaw doctor --fix output:

Doctor complete.

It did not detect or repair the missing bundled extension dependencies.


Workaround That Fixed It

Manually batch-installed all dependencies declared by bundled extension manifests:

cd ~/.openclaw/lib/node_modules/openclaw && npm install --omit=dev --no-save --package-lock=false --ignore-scripts --legacy-peer-deps $(node -e 'const fs=require("fs"),path=require("path");const root=path.join(process.cwd(),"dist","extensions");const seen=new Map();for(const entry of fs.readdirSync(root,{withFileTypes:true})){if(!entry.isDirectory())continue;const pkgPath=path.join(root,entry.name,"package.json");if(!fs.existsSync(pkgPath))continue;const pkg=JSON.parse(fs.readFileSync(pkgPath,"utf8"));for(const [name,version] of Object.entries(pkg.dependencies||{})){if(!seen.has(name))seen.set(name,name+"@"+version);}}process.stdout.write([...seen.values()].join(" "));')

After running:

~/.openclaw/bin/openclaw gateway restart
~/.openclaw/bin/openclaw onboard

everything worked as expected.


Notes

This appears to be caused by one or more of the following:

  • Bundled plugin runtime dependencies are not being mirrored or installed correctly in this beta
  • doctor --fix is not detecting all missing bundled runtime dependencies
  • Install/update process may leave stale or unsafe dist/extensions/*/node_modules state behind

Steps to reproduce

On WSL Ubuntu 22.04 with Node v22.22.2, install OpenClaw 2026.4.20-beta.2 via either: the installer script, or a clean reinstall using: openclaw gateway uninstall npm uninstall -g openclaw curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --version 2026.4.20-beta.2 ~/.openclaw/bin/openclaw gateway install --force ~/.openclaw/bin/openclaw gateway restart Run: openclaw doctor --fix Run: openclaw onboard Observe onboarding fail with missing bundled extension runtime dependencies, e.g.: Cannot find module '@larksuiteoapi/node-sdk' Cannot find module 'nostr-tools'

Expected behavior

NOT_ENOUGH_INFO

Actual behavior

openclaw onboard fails during onboarding with missing module errors from bundled extensions, including:

Error: Cannot find module '@larksuiteoapi/node-sdk' Require stack: /home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/feishu/client-yWGpoGkZ.js After installing that, another failure: Error: Cannot find module 'nostr-tools' Require stack: /home/<user>/.openclaw/lib/node_modules/openclaw/dist/extensions/nostr/setup-surface-d0cfZ0y8.js

Additionally, openclaw doctor --fix reports Doctor complete. and does not flag or repair the issue.

OpenClaw version

2026.4.20-beta.2

Operating system

Ubuntu 22.04 WSL

Install method

npm

Model

openai-codex/gpt-5.4

Provider / routing chain

openclaw

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

extent analysis

TL;DR

Manually installing missing dependencies or modifying the install process to include bundled extension dependencies may resolve the issue with OpenClaw onboarding failing due to missing modules.

Guidance

  1. Verify the issue: Confirm that the problem persists after running openclaw doctor --fix and attempting to onboard with openclaw onboard.
  2. Manual dependency installation: Try manually installing the missing dependencies using the provided workaround script or by individually installing the required packages (e.g., @larksuiteoapi/node-sdk and nostr-tools) in the OpenClaw package directory.
  3. Check doctor --fix functionality: Investigate why openclaw doctor --fix does not detect or repair the missing bundled extension dependencies, as this might be a key part of the solution.
  4. Review install process: Examine the install process for OpenClaw, particularly how it handles bundled extension dependencies, to identify potential issues or omissions that could lead to missing modules during onboarding.

Example

The workaround script provided in the issue body can be used as a starting point:

cd ~/.openclaw/lib/node_modules/openclaw && npm install --omit=dev --no-save --package-lock=false --ignore-scripts --legacy-peer-deps $(node -e 'const fs=require("fs"),path=require("path");const root=path.join(process.cwd(),"dist","extensions");const seen=new Map();for(const entry of fs.readdirSync(root,{withFileTypes:true})){if(!entry.isDirectory())continue;const pkgPath=path.join(root,entry.name,"package.json");if(!fs.existsSync(pkgPath))continue;const pkg=JSON.parse(fs.readFileSync(pkgPath,"utf8"));for(const [name,version] of Object.entries(pkg.dependencies||{})){if(!seen.has(name))seen.set(name,name+"@"+version);}}process.stdout.write([...seen.values()].join(" "));')

This script installs the dependencies declared by the bundled extension manifests.

Notes

  • The root cause of the issue seems to be related to how OpenClaw handles bundled extension dependencies during installation or the doctor --fix process.
  • The provided workaround fixes the issue by manually installing the required dependencies, but a more permanent solution would involve modifying the OpenClaw installation or doctor --fix process to correctly handle these dependencies.

Recommendation

Apply the workaround by manually installing the missing dependencies as described, and consider reporting the issue to the OpenClaw developers to ensure a more robust solution is integrated into future versions.

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

NOT_ENOUGH_INFO

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 2026.4.20-beta.2 on WSL Ubuntu 22.04: bundled extension runtime deps missing after install/onboard, doctor --fix reports complete [2 comments, 3 participants]