openclaw - 💡(How to fix) Fix fix: 2026.3.13-zh.1 包构建产物缺失，导致 CLI 无法运行 [1 participants]

TL;DR

The most likely fix is to ensure the dist directory and its contents are properly included in the npm package by updating the files field in package.json and verifying the bin field points to the correct executable.

Guidance

• Verify that the dist directory and its contents, including entry.js and subsystem-*.js, are included in the files field of package.json to ensure they are packaged correctly.
• Check the bin field in package.json to ensure it points to the correct executable, such as "bin": { "openclaw": "dist/entry.js" }, to fix the global executable linking issue.
• Run npm pack --dry-run to test the packaging process and verify that all necessary files are included before publishing the package.
• Consider adding a CI check to verify the package contents before release to prevent similar issues in the future.

Example

{
  "name": "@qingchencloud/openclaw-zh",
  "version": "2026.3.13-zh.1",
  "files": [
    "dist/**",
    "openclaw.mjs"
  ],
  "bin": {
    "openclaw": "dist/entry.js"
  }
}

Notes

The issue seems to be related to the packaging process, and the provided suggestions should help resolve the problem. However, if the issue persists, further investigation into the build process and CI pipeline may be necessary.

Recommendation

Apply the suggested workaround by updating the files and bin fields in package.json and verifying the package contents using npm pack --dry-run. This should ensure that the necessary files are included in the package and the global executable is linked correctly.