openclaw - ✅(Solved) Fix Missing BOOTSTRAP.md in dist/docs/reference/templates/ (packaging bug) [1 pull requests, 1 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#56155Fetched 2026-04-08 01:44:23
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
cross-referenced ×2referenced ×1

Error Message

Error: Missing workspace template: BOOTSTRAP.md (/Users/shazyasif/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/docs/reference/templates/BOOTSTRAP.md). Ensure docs/reference/templates are packaged.

Root Cause

The file exists at docs/reference/templates/BOOTSTRAP.md in the source package but is NOT copied to dist/docs/reference/templates/ during build.

Fix Action

Workaround

Manually copy the file:

cp docs/reference/templates/BOOTSTRAP.md dist/docs/reference/templates/BOOTSTRAP.md

PR fix notes

PR #56189: fix: include BOOTSTRAP.md template in npm package (#56155)

Description (problem / solution / changelog)

Summary

  • Added docs/reference/templates/ to package.json files array
  • Ensures BOOTSTRAP.md workspace template is included in the published npm package
  • Prevents runtime error "Missing workspace template: BOOTSTRAP.md" when seeding new agent workspaces

Test plan

  • Verified docs/reference/templates/BOOTSTRAP.md exists in source
  • npm pack --dry-run confirms file is included in package output

Closes #56155

Changed files

  • package.json (modified, +1/-0)

Code Example

Error: Missing workspace template: BOOTSTRAP.md (/Users/shazyasif/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/docs/reference/templates/BOOTSTRAP.md). Ensure docs/reference/templates are packaged.

---

cp docs/reference/templates/BOOTSTRAP.md dist/docs/reference/templates/BOOTSTRAP.md
RAW_BUFFERClick to expand / collapse

Error

Error: Missing workspace template: BOOTSTRAP.md (/Users/shazyasif/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/dist/docs/reference/templates/BOOTSTRAP.md). Ensure docs/reference/templates are packaged.

Root Cause

The file exists at docs/reference/templates/BOOTSTRAP.md in the source package but is NOT copied to dist/docs/reference/templates/ during build.

Environment

  • Version: OpenClaw 2026.3.24 (cff6dc9)

Workaround

Manually copy the file:

cp docs/reference/templates/BOOTSTRAP.md dist/docs/reference/templates/BOOTSTRAP.md

Request

Please fix the build script to include all files from docs/reference/templates/ in dist/docs/reference/templates/

extent analysis

Fix Plan

To fix the issue, we need to update the build script to include all files from docs/reference/templates/ in dist/docs/reference/templates/.

  • Update the package.json file to include a script that copies the template files during build:
"scripts": {
  "build": "node build.js && cp -r docs/reference/templates dist/docs/reference/",
  ...
}

Alternatively, if you're using a build tool like Webpack or Rollup, you can configure it to copy the files:

// webpack.config.js
module.exports = {
  // ... other configurations ...
  plugins: [
    new CopyPlugin({
      patterns: [
        { from: 'docs/reference/templates', to: 'dist/docs/reference/templates' },
      ],
    }),
  ],
};
  • If you're using a build.js file, you can add the following code to copy the files:
const fs = require('fs-extra');

fs.copy('docs/reference/templates', 'dist/docs/reference/templates');

Verification

To verify that the fix worked, run the build script and check if the BOOTSTRAP.md file is copied to dist/docs/reference/templates/.

Extra Tips

  • Make sure to update the build script to handle any other files or directories that need to be copied.
  • Consider using a build tool like Webpack or Rollup to manage your build process and handle file copying.
  • If you're using a CI/CD pipeline, make sure to update the pipeline to include the updated build script.

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…

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 Missing BOOTSTRAP.md in dist/docs/reference/templates/ (packaging bug) [1 pull requests, 1 participants]