openclaw - 💡(How to fix) Fix Bug: plugin runtime loader fallback resolves to missing /usr/lib/node_modules/plugins/loader.js [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

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#75010Fetched 2026-05-01 05:39:06
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
3
Timeline (top)
closed ×1commented ×1

After upgrading OpenClaw to v2026.4.27, openclaw status failed with:

Could not load plugin runtime loader for channel setup fallback.

The gateway itself was reachable and healthy, but CLI/plugin fallback operations failed until a loader shim was added.

Error Message

The compiled runtime attempted to resolve the plugin runtime loader at:

Root Cause

After upgrading OpenClaw to v2026.4.27, openclaw status failed with:

Could not load plugin runtime loader for channel setup fallback.

The gateway itself was reachable and healthy, but CLI/plugin fallback operations failed until a loader shim was added.

Fix Action

Temporary workaround

Creating this shim restored CLI/plugin checks:

// /usr/lib/node_modules/plugins/loader.js
module.exports = require("../openclaw/dist/plugins/build-smoke-entry.js");

After adding the shim, these checks passed:

openclaw status
openclaw plugins list
openclaw plugins doctor
openclaw gateway health

Code Example

Could not load plugin runtime loader for channel setup fallback.

---

/usr/lib/node_modules/plugins/loader.js

---

// /usr/lib/node_modules/plugins/loader.js
module.exports = require("../openclaw/dist/plugins/build-smoke-entry.js");

---

openclaw status
openclaw plugins list
openclaw plugins doctor
openclaw gateway health

---

/usr/lib/node_modules/openclaw/dist/plugins/build-smoke-entry.js
RAW_BUFFERClick to expand / collapse

Summary

After upgrading OpenClaw to v2026.4.27, openclaw status failed with:

Could not load plugin runtime loader for channel setup fallback.

The gateway itself was reachable and healthy, but CLI/plugin fallback operations failed until a loader shim was added.

Environment

  • OpenClaw version: v2026.4.27
  • Install style: global npm install under /usr/lib/node_modules/openclaw
  • Affected commands observed:
    • openclaw status
    • plugin fallback/runtime loader path resolution

Observed behavior

The compiled runtime attempted to resolve the plugin runtime loader at:

/usr/lib/node_modules/plugins/loader.js

That file did not exist, causing openclaw status to fail with the loader error above.

Temporary workaround

Creating this shim restored CLI/plugin checks:

// /usr/lib/node_modules/plugins/loader.js
module.exports = require("../openclaw/dist/plugins/build-smoke-entry.js");

After adding the shim, these checks passed:

openclaw status
openclaw plugins list
openclaw plugins doctor
openclaw gateway health

Expected behavior

The loader should resolve to the installed OpenClaw package path, for example:

/usr/lib/node_modules/openclaw/dist/plugins/build-smoke-entry.js

or otherwise ship/create the expected fallback path during install/update.

Notes

This looks like a path resolution issue in the compiled fallback loader logic after the v2026.4.27 update, rather than a channel/plugin configuration issue. openclaw plugins doctor reported no plugin issues after the shim was added.

extent analysis

TL;DR

The issue can be fixed by ensuring the plugin runtime loader resolves to the correct path, potentially by adjusting the loader logic or creating a shim.

Guidance

  • Verify that the openclaw package is installed correctly and the dist/plugins/build-smoke-entry.js file exists in the expected location.
  • Check the loader logic in the openclaw package to see if it can be updated to resolve the plugin runtime loader path correctly.
  • If a fix is not available, create a shim like the temporary workaround provided to restore CLI/plugin checks.
  • Test the openclaw status and other affected commands after applying any changes to ensure they are working as expected.

Example

// Example shim to restore CLI/plugin checks
// /usr/lib/node_modules/plugins/loader.js
module.exports = require("../openclaw/dist/plugins/build-smoke-entry.js");

Notes

The issue seems to be related to a path resolution problem in the compiled fallback loader logic after the v2026.4.27 update. The provided temporary workaround suggests that creating a shim can resolve the issue, but a more permanent fix may involve updating the loader logic in the openclaw package.

Recommendation

Apply the workaround by creating a shim, as it has been shown to restore CLI/plugin checks and resolve the issue temporarily, until a more permanent fix is available.

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

Temporary workaround

Creating this shim restored CLI/plugin checks:

// /usr/lib/node_modules/plugins/loader.js
module.exports = require("../openclaw/dist/plugins/build-smoke-entry.js");

After adding the shim, these checks passed:

openclaw status
openclaw plugins list
openclaw plugins doctor
openclaw gateway health

Expected behavior

The loader should resolve to the installed OpenClaw package path, for example:

/usr/lib/node_modules/openclaw/dist/plugins/build-smoke-entry.js

or otherwise ship/create the expected fallback path during install/update.

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: plugin runtime loader fallback resolves to missing /usr/lib/node_modules/plugins/loader.js [1 comments, 2 participants]