openclaw - 💡(How to fix) Fix Tool turns can fail on stale hashed pi-tools.before-tool-call runtime import [1 participants]

Summary

Some tool turns can fail before execution with a missing bundled runtime module error like:

Cannot find module '/opt/homebrew/lib/node_modules/openclaw/dist/pi-tools.before-tool-call.runtime-CT4-8YQv.js'

On the affected install, the package actually contained:

• dist/pi-tools.before-tool-call.runtime.js
• dist/pi-tools.before-tool-call.runtime-j0A_sHKG.js

but not the stale hashed filename being requested.

Observed impact

This breaks tool execution in-session before the real tool call happens, so filesystem and messaging actions can become unavailable in an otherwise healthy running gateway.

What I verified

• openclaw status was healthy overall.
• dist/pi-tools.before-tool-call.runtime.js correctly re-exported the current hashed chunk.
• The stale hashed filename was still being referenced somewhere at runtime or in persisted session state.
• Creating a symlink from the missing stale filename to the current chunk immediately restored imports and tool execution.

Local workaround

cd /opt/homebrew/lib/node_modules/openclaw/dist
ln -s pi-tools.before-tool-call.runtime-j0A_sHKG.js pi-tools.before-tool-call.runtime-CT4-8YQv.js

Likely root cause

A stale hashed chunk reference survived an update, partial install, or persisted runtime/session state. The current package ships a stable alias (pi-tools.before-tool-call.runtime.js), but some path in the runtime still tries to import the old hashed filename directly.

Expected behavior

Runtime imports should go through the stable alias or otherwise tolerate hashed filename churn across updates, so package updates do not strand active sessions/tool loops on missing chunk names.

Suggested fix directions

• Ensure all dynamic imports use the stable alias file instead of concrete hashed chunk names.
• Audit persisted session/runtime metadata so hashed chunk filenames are never stored across restarts/updates.
• Consider a startup/runtime sanity check that detects missing hashed sidecars referenced by persisted state and rewrites them to stable aliases.

Environment

• OpenClaw: 2026.4.8
• Install path: /opt/homebrew/lib/node_modules/openclaw
• Platform: macOS arm64