Openclaw Doctor | Friends of the Crustacean 🦞🤝 | Page 1

oak night May 10, 2026, 6:35 PM

#

My openclaw doctor returns these results. I don't understand many of them. Can you walk me through each and how to fix them please?

OpenClaw doctor
│
◇ Update ──────────────────────────────────────────────────────────────────────────────────╮
│ │
│ This install is not a git checkout. │
│ Run openclaw update to update via your package manager (npm/pnpm), then rerun doctor. │
│ │
├───────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ Config warnings ───────────────────────────────────────────────────────────────────────╮
│ │
│ - plugins.entries.openclaw-web-search: plugin openclaw-web-search: installed plugin │
│ package requires compiled runtime output for TypeScript entry index.ts: expected │
│ ./dist/index.js, ./dist/index.mjs, ./dist/index.cjs, index.js, index.mjs, index.cjs │
│ │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ Doctor warnings ─────────────────────────────────────────────────────────────────────╮
│ │
│ - plugins.allow is restrictive, but bundled provider discovery is still in legacy │
│ compatibility mode. Bundled provider plugins can still appear in runtime provider │
│ inventories; set plugins.bundledDiscovery to "allowlist" after confirming omitted │
│ bundled providers are intentionally blocked. │
│ │

half bobcatBOT May 10, 2026, 6:35 PM

#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

lavish terraceBOT May 10, 2026, 6:36 PM

#

Yep — these are mostly warnings, not “OpenClaw is broken” errors. I’d handle them in this order:

Update: “This install is not a git checkout”
This just means you installed OpenClaw as a package, not by cloning the repo. That’s normal for most users.

Fix/check:

openclaw --version
openclaw update
openclaw doctor

openclaw update will use the package-manager update path for packaged installs, then refresh plugin sync/restart work where applicable.

Config warning: plugins.entries.openclaw-web-search needs compiled runtime output
This means the openclaw-web-search plugin package OpenClaw found points at index.ts, but the installed npm/plugin package does not include the compiled JS file OpenClaw needs at runtime, like dist/index.js.

Important bit: this is usually a plugin packaging/version problem, not something you personally configured wrong.

#

Try:

openclaw update
openclaw plugins update openclaw-web-search
openclaw doctor --fix
openclaw doctor

If it still warns and you don’t need that plugin right now, disable or uninstall it until a fixed package is available:

openclaw plugins disable openclaw-web-search
# or, if you want it removed:
openclaw plugins uninstall openclaw-web-search

Doctor warning: plugins.allow is restrictive, but bundled discovery is legacy/compat
You have a plugin allowlist. That means you’re saying “only these plugins should load.” But OpenClaw is currently preserving older compatibility behavior where some bundled provider plugins may still show up even if they’re not in plugins.allow.

#

If you intentionally want strict allowlist behavior, set:

openclaw config set plugins.bundledDiscovery allowlist
openclaw gateway restart
openclaw doctor

If you’re not sure why plugins.allow is set, first inspect it:

openclaw config get plugins.allow
openclaw config get plugins.bundledDiscovery
openclaw plugins list --enabled

My recommendation: fix/update the web-search plugin first, then only set plugins.bundledDiscovery to allowlist if you actually want omitted bundled providers blocked.

Docs for the exact areas:

#Openclaw Doctor