openclaw - 💡(How to fix) Fix plugin runtime: avoid or explain openclaw-unknown cache keys [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#72264Fetched 2026-04-27 05:32:19
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
0
Timeline (top)
closed ×1commented ×1

Code Example

~/.openclaw/plugin-runtime-deps/openclaw-2026.4.24-17c3fa238f70
~/.openclaw/plugin-runtime-deps/openclaw-unknown-2c9d7f6bd55e

---

plugin runtime cache key fallback=openclaw-unknown reason=package-version-unavailable
RAW_BUFFERClick to expand / collapse

Problem

Plugin runtime dependency caches can appear under both versioned and openclaw-unknown-* directories, e.g.

~/.openclaw/plugin-runtime-deps/openclaw-2026.4.24-17c3fa238f70
~/.openclaw/plugin-runtime-deps/openclaw-unknown-2c9d7f6bd55e

Logs may then show channel plugin runtime code loading through the openclaw-unknown-* path.

That is confusing operationally and may lead to duplicate installs/cache churn. If openclaw-unknown-* is expected, the docs and logs should explain why. If not, the runtime should avoid it for packaged/global installs.

Suggested fix

  • Ensure global/npm/package installs resolve a stable OpenClaw version/build id for plugin runtime cache keys.
  • Only fall back to openclaw-unknown-* when unavoidable.
  • If fallback is used, log the reason explicitly, e.g.
    plugin runtime cache key fallback=openclaw-unknown reason=package-version-unavailable
  • Add a doctor advisory when the active runtime path uses an unknown cache key.

Why

When debugging WhatsApp/Baileys reconnect loops and missing runtime deps, duplicate cache keys make it much harder to determine which runtime is actually active and whether a cache rebuild succeeded.

extent analysis

TL;DR

Ensure global/package installs resolve a stable OpenClaw version/build id for plugin runtime cache keys to avoid using openclaw-unknown-* directories.

Guidance

  • Review the plugin runtime cache key resolution logic to ensure it prioritizes stable version/build ids over openclaw-unknown-* fallbacks.
  • Implement explicit logging for fallback reasons, such as package-version-unavailable, to aid in debugging.
  • Consider adding a doctor advisory when the active runtime path uses an unknown cache key to alert operators of potential issues.
  • Verify that the suggested fix resolves the duplicate cache key issue and improves debugging of reconnect loops and missing runtime dependencies.

Example

No code snippet is provided as the issue does not contain sufficient code context.

Notes

The suggested fix assumes that the openclaw-unknown-* directories are not intended behavior for packaged/global installs. If these directories are expected, additional documentation and logging explanations are necessary.

Recommendation

Apply workaround: Ensure global/package installs resolve a stable OpenClaw version/build id for plugin runtime cache keys, as this addresses the root cause of the issue and provides a clear path forward for resolving duplicate cache key problems.

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

openclaw - 💡(How to fix) Fix plugin runtime: avoid or explain openclaw-unknown cache keys [1 comments, 2 participants]