openclaw - 💡(How to fix) Fix `subagent-registry.runtime.js` still missing from `dist/` in 2026.4.12 npm package — file genuinely absent (follow-up to closed #71418) [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#76147Fetched 2026-05-03 04:41:49
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
2
Timeline (top)
closed ×1commented ×1unsubscribed ×1

Error Message

[warn] subagent cleanup finalize failed (<uuid>): Error [ERR_MODULE_NOT_FOUND]: The error message is not a phantom — the file is genuinely missing from the published 2026.4.12 npm package's dist/ directory:

  • Closure history is misleading: the issue has been closed five times. Anyone searching for this error trail trusts the closures.

Root Cause

I am opening this as a new issue rather than commenting because #71418 is locked.

Code Example

[warn] subagent cleanup finalize failed (<uuid>): Error [ERR_MODULE_NOT_FOUND]: 
  Cannot find module '/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry.runtime.js'
  imported from /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-CflSFWBm.js

---

$ ls /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry.runtime.js
ls: cannot access '...subagent-registry.runtime.js': No such file or directory

$ ls /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-*.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-CflSFWBm.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-read-DpozRxeB.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-state-BdkWjAs7.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-steer-runtime-DlsbxWM7.js

---

$ openclaw --version
OpenClaw 2026.4.12 (1c0672b)

$ cat /data/.npm-global/lib/node_modules/openclaw/package.json | grep '"version"'
  "version": "2026.4.12",
RAW_BUFFERClick to expand / collapse

Symptom

On a fresh gateway boot of openclaw 2026.4.12, the following warning fires 18 times:

[warn] subagent cleanup finalize failed (<uuid>): Error [ERR_MODULE_NOT_FOUND]: 
  Cannot find module '/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry.runtime.js'
  imported from /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-CflSFWBm.js

This is the same symptom reported in closed issues #71418, #67044, #66527, #66313, #66096. All five were closed-as-fixed, the most recent being #71418 closed on 2026-04-25.

I am opening this as a new issue rather than commenting because #71418 is locked.

Direct file-existence verification

The error message is not a phantom — the file is genuinely missing from the published 2026.4.12 npm package's dist/ directory:

$ ls /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry.runtime.js
ls: cannot access '...subagent-registry.runtime.js': No such file or directory

$ ls /data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-*.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-CflSFWBm.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-read-DpozRxeB.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-state-BdkWjAs7.js
/data/.npm-global/lib/node_modules/openclaw/dist/subagent-registry-steer-runtime-DlsbxWM7.js

The four sibling chunks (...-CflSFWBm, ...-read-..., ...-state-..., ...-steer-runtime-...) are present, but the subagent-registry.runtime.js referenced by the import in subagent-registry-CflSFWBm.js is not.

Version

$ openclaw --version
OpenClaw 2026.4.12 (1c0672b)

$ cat /data/.npm-global/lib/node_modules/openclaw/package.json | grep '"version"'
  "version": "2026.4.12",

Repro

  1. Install openclaw from npm: npm install -g [email protected] (or use any container that bundles 2026.4.12).
  2. Start the gateway: openclaw gateway.
  3. Watch the gateway log for the warning above. With ~18 stale subagent UUIDs needing cleanup, the warning fires 18 times within ~1s of gateway boot.

Possible causes (for maintainer to disambiguate)

  • The fix that landed against #71418 was in a sibling chunk file, not in the missing .runtime.js — so the import target was never restored.
  • The published 2026.4.12 npm package was assembled before the fix landed, and the fix is in a later version.
  • The build system regressed and stopped emitting .runtime.js again after #71418's closure.

Why it matters

  • Log noise: 18 ERR_MODULE_NOT_FOUND warnings per gateway boot is non-trivial noise.
  • Trust signal: the warning text says subagent cleanup finalize failed, which sounds load-bearing even if the cleanup itself is benign. Operators who see this assume something is broken.
  • Closure history is misleading: the issue has been closed five times. Anyone searching for this error trail trusts the closures.

Severity

Low operational impact (cleanup is for stale subagent UUIDs, not active runs), but high signal-to-noise damage: the warning makes openclaw look broken on first boot to anyone evaluating it.

Tested-against

openclaw 2026.4.12 (commit 1c0672b) installed via npm install -g openclaw to /data/.npm-global/lib/node_modules/openclaw/. Repros 2026-05-02 on a fresh openclaw gateway invocation.

Suggested resolution

Either:

  1. Confirm the fix is in a later release and update the linked closed issues to say "fix landed in 2026.4.13" (or whichever).
  2. If 2026.4.12 was supposed to contain the fix, reopen — the file is verifiably absent.

extent analysis

TL;DR

The missing subagent-registry.runtime.js file in the dist/ directory of the openclaw 2026.4.12 npm package is likely causing the ERR_MODULE_NOT_FOUND warnings.

Guidance

  • Verify that the file subagent-registry.runtime.js is indeed missing from the dist/ directory of the openclaw 2026.4.12 npm package.
  • Check the commit history to see if the fix for the issue was actually included in the 2026.4.12 release.
  • Consider updating to a later version of openclaw if the fix is confirmed to be in a later release.
  • If the fix was supposed to be in 2026.4.12, reopen the issue to investigate further.

Example

No code snippet is provided as the issue is related to a missing file in the npm package.

Notes

The issue has been closed five times previously, but the warning persists, indicating that the fix may not have been properly included in the 2026.4.12 release.

Recommendation

Apply workaround: update to a later version of openclaw if the fix is confirmed to be in a later release, as the current version has a verified missing file causing the error.

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