openclaw - 💡(How to fix) Fix ERR_MODULE_NOT_FOUND for `subagent-registry.runtime.js` on every gateway boot [1 comments, 2 participants]

On every gateway boot, the openclaw-deep-observability plugin's hook registration produces three [warn] subagent cleanup finalize failed entries because an internal module file is missing from the published dist/: [warn] subagent cleanup finalize failed (90a1fefc-8de5-430f-9a7f-2b84beb8628c): Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/usr/local/lib/node_modules/openclaw/dist/subagent-registry.runtime.js' imported from /usr/local/lib/node_modules/openclaw/dist/subagent-registry-CflSFWBm.js subagent-registry-CflSFWBm.js (a bundled chunk) does import('./subagent-registry.runtime.js') lazily during cleanup, but subagent-registry.runtime.js is not present in the npm package. The cleanup path silently swallows the error and the warning is logged.

TL;DR

The issue can be fixed by including the missing subagent-registry.runtime.js file in the published dist/ directory or by inlining the runtime helper into the bundle.

Guidance

• Verify that the subagent-registry.runtime.js file is indeed missing from the dist/ directory in the published npm package.
• Check the build process to ensure that the file is not being excluded or ignored during the bundling process.
• Consider inlining the runtime helper into the bundle to avoid the need for a dynamic import() statement.
• Review the cleanup path to ensure that errors are properly handled and logged, rather than being silently swallowed.

Example

No code snippet is provided as the issue is related to a missing file in the published package, rather than a code-specific problem.

Notes

The issue is currently cosmetic, but it can lead to accumulation of orphan subagent records over time and adds noise to logs. The fix should be applied to prevent potential issues in the future.

Recommendation

Apply a workaround by inlining the runtime helper into the bundle, as this approach avoids the need for a dynamic import() statement and ensures that the cleanup process can complete successfully.