openclaw - 💡(How to fix) Fix doctor/plugins: add first-class repair for bundled plugin runtime deps [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#72263Fetched 2026-04-27 05:32:21
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
0
Timeline (top)
closed ×1commented ×1

Code Example

Bundled plugin runtime deps are missing.
- @whiskeysockets/baileys@7.0.0-rc.9 (used by whatsapp)
- jimp@^1.6.1 (used by whatsapp)
- typebox@1.1.31 (used by whatsapp)
- undici@8.1.0 (used by whatsapp)
...

---

openclaw plugins runtime-deps status
openclaw plugins runtime-deps rebuild
openclaw plugins runtime-deps prune

---

openclaw doctor --fix

---

Bundled plugin runtime deps are missing.
Repair: openclaw doctor --fix
Manual repair: openclaw plugins runtime-deps rebuild
RAW_BUFFERClick to expand / collapse

Problem

When bundled plugin runtime dependencies are missing or stale, openclaw doctor reports the missing packages, but the repair path is not obvious.

Example output after a runtime cache reset:

Bundled plugin runtime deps are missing.
- @whiskeysockets/[email protected] (used by whatsapp)
- jimp@^1.6.1 (used by whatsapp)
- [email protected] (used by whatsapp)
- [email protected] (used by whatsapp)
...

This is especially painful for channel plugins like WhatsApp where broken/missing runtime deps can present as reconnect loops or transport errors.

Suggested product fix

Add first-class commands such as:

openclaw plugins runtime-deps status
openclaw plugins runtime-deps rebuild
openclaw plugins runtime-deps prune

And/or make this repair explicit in:

openclaw doctor --fix

Suggested doctor UX

When deps are missing, print a direct next step:

Bundled plugin runtime deps are missing.
Repair: openclaw doctor --fix
Manual repair: openclaw plugins runtime-deps rebuild

Suggested docs fix

Add a troubleshooting section explaining:

  • what ~/.openclaw/plugin-runtime-deps is
  • when it is safe to move the directory aside
  • how runtime deps are keyed by OpenClaw version/build
  • how to rebuild them deterministically
  • how to verify repair with openclaw doctor and openclaw channels status --probe

Why

The runtime dependency cache is currently an important operational surface, but users have to infer the repair process from logs and filesystem state.

extent analysis

TL;DR

Run openclaw plugins runtime-deps rebuild to potentially repair missing bundled plugin runtime dependencies.

Guidance

  • The issue is likely caused by missing or stale runtime dependencies, which can be verified by checking the output of openclaw doctor.
  • To mitigate the issue, try running openclaw plugins runtime-deps rebuild to rebuild the missing dependencies.
  • If the issue persists, consider checking the ~/.openclaw/plugin-runtime-deps directory and its contents to understand the current state of the runtime dependencies.
  • Use openclaw doctor and openclaw channels status --probe to verify the repair after rebuilding the dependencies.

Example

No code snippet is provided as it is not clearly supported by the issue.

Notes

The provided solution is based on the suggested product fix and may not be an official or final solution. The issue lacks information on the exact implementation and version of the openclaw command.

Recommendation

Apply workaround: Run openclaw plugins runtime-deps rebuild to repair missing dependencies, as it is a direct and explicit step to address the issue.

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 doctor/plugins: add first-class repair for bundled plugin runtime deps [1 comments, 2 participants]