-
-
Notifications
You must be signed in to change notification settings - Fork 69.5k
doctor --fix doesn't remove stale plugin entries from plugins.allow #53160
Description
Description
openclaw doctor --fix detects stale plugin entries in plugins.allow but doesn't auto-remove them. The gateway then refuses to start because v2026.3.22 validates plugins.allow strictly.
Steps to Reproduce
- Install a plugin (e.g.
acpx) - Remove/uninstall the plugin
- Leave the entry in
plugins.allowandplugins.entriesinopenclaw.json - Upgrade to v2026.3.22
- Gateway fails to start:
Invalid config: plugins.allow: plugin not found: acpx - Run
openclaw doctor --fix— it detects the stale entry but does not remove it
Expected Behaviour
openclaw doctor --fix should remove stale plugin entries from both plugins.allow and plugins.entries when the referenced plugin is not installed.
Actual Behaviour
Doctor reports the warning but leaves the config unchanged. The gateway remains broken until you manually edit openclaw.json.
Workaround
Manually remove the stale plugin from plugins.allow and plugins.entries in ~/.openclaw/openclaw.json, then openclaw gateway restart.
Environment
- OpenClaw v2026.3.22
- Ubuntu 24.04 (arm64)
- Affected 3 of 5 agents in our fleet (all had acpx previously installed then removed)
Impact
This is a fleet-wide issue — any agent that previously had a plugin installed and removed will break on upgrade to v2026.3.22+ since the stricter config validation was introduced. The fix is trivial (a JSON edit) but the failure mode is opaque for users who don't know to check plugins.allow.