Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: scripts are missing in npm package. -> sandboxing not possible cause install scripts are missing [1 pull requests, 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#75485•Fetched 2026-05-02 05:34:03
View on GitHub
Comments
1
Participants
2
Timeline
6
Reactions
2
Author
Triggsy22Triggsy22
Participants
clawsweeper[bot]clawsweeper[bot]Triggsy22Triggsy22
Timeline (top)
referenced ×2closed ×1commented ×1cross-referenced ×1

In the npm package, all the scripts from https://github.com/openclaw/openclaw/tree/main/scripts are missing.

Nearly all scripts commands in package.json are not working, because the appropriate scripts are not in the npm package.

Error Message

  1. Error Message: Cannot find module .../scripts/tsdown-build.mjs
  2. Error Mssage: sandbox-setup.sh: No such file or directory

Root Cause

Nearly all scripts commands in package.json are not working, because the appropriate scripts are not in the npm package.

Fix Action

Fixed

PR fix notes

PR #75594: docs(sandboxing): clarify sandbox setup scripts require source checkout

Description (problem / solution / changelog)

Summary

The sandbox documentation references scripts/sandbox-setup.sh, scripts/sandbox-common-setup.sh, and scripts/sandbox-browser-setup.sh for building sandbox Docker images. These scripts are only available in a source checkout — they are intentionally excluded from the npm package via the files allowlist in package.json.

Users who install OpenClaw via npm install -g openclaw hit "No such file or directory" when following the docs.

Changes

  • docs/gateway/sandboxing.md (primary reference): Add a <Note> callout explaining source-checkout vs npm-install, provide inline docker build commands for the default sandbox image, and link to the GitHub Dockerfiles for the common and browser images.
  • docs/gateway/configuration.md, docs/gateway/config-agents.md, docs/install/docker.md, docs/install/ansible.md: Add "(from a source checkout)" qualifiers and cross-link to the new inline instructions in the sandboxing docs.
  • CHANGELOG.md: Add entry.

Fixes #75485.

Changed files

  • CHANGELOG.md (modified, +1/-0)
  • docs/gateway/config-agents.md (modified, +3/-1)
  • docs/gateway/configuration.md (modified, +1/-1)
  • docs/gateway/sandboxing.md (modified, +36/-1)
  • docs/install/ansible.md (modified, +3/-1)
  • docs/install/docker.md (modified, +4/-1)
RAW_BUFFERClick to expand / collapse

Bug type

Crash (process/app exits or hangs)

Beta release blocker

No

Summary

In the npm package, all the scripts from https://github.com/openclaw/openclaw/tree/main/scripts are missing.

Nearly all scripts commands in package.json are not working, because the appropriate scripts are not in the npm package.

Steps to reproduce

  1. install openclaw with: npm install -g openclaw@latest
  2. navigate to the global installed npm openclaw folder
  3. try to call a command like: npm run build:docker
  4. Error Message: Cannot find module .../scripts/tsdown-build.mjs
  5. Navigate to scripts
  6. try to call sandbox-setup.sh or sandbox-common-setup.sh as mention in the Sandboxing Documentation
  7. Error Mssage: sandbox-setup.sh: No such file or directory

Expected behavior

All Scripts from https://github.com/openclaw/openclaw/tree/main/scripts should be in the npm package https://www.npmjs.com/package/openclaw?activeTab=code. So that all commands in the package.json and all scripts from the documentation are working as expected.

Actual behavior

Files missing.

OpenClaw version

2026.4.29

Operating system

Debian 6.12.74-2 (2026-03-08) x86_64

Install method

npm global

Model

deepseek v4 flash

Provider / routing chain

there isnt a routing chain.

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 missing scripts in the npm package can be fixed by ensuring they are properly included in the package during the build or publishing process.

Guidance

  • Verify that the scripts directory is included in the files field of the package.json file to ensure it is packaged with the npm package.
  • Check the build or publishing script to ensure it is copying the necessary files from the scripts directory into the package.
  • Review the npm package contents after installation to confirm the scripts are present.
  • Consider manually adding the missing scripts to the package as a temporary workaround, but this should not be a long-term solution.

Example

No code example is provided as the issue is related to packaging and distribution rather than code functionality.

Notes

The exact solution may depend on the specifics of the build and publishing process used by the openclaw project, which is not detailed in the issue.

Recommendation

Apply workaround: Manually add the missing scripts to the package or modify the build/publishing process to include them, as upgrading to a fixed version is not currently an option.

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

All Scripts from https://github.com/openclaw/openclaw/tree/main/scripts should be in the npm package https://www.npmjs.com/package/openclaw?activeTab=code. So that all commands in the package.json and all scripts from the documentation are working as expected.

#device allocation#model download#tokenizer error#prompt formatting#chain 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 - ✅(Solved) Fix [Bug]: scripts are missing in npm package. -> sandboxing not possible cause install scripts are missing [1 pull requests, 1 comments, 2 participants]