openclaw - 💡(How to fix) Fix docs/config: plugins.allow allowlist silently blocks all stock channel plugins (Discord, Signal, etc.) when set [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#58009Fetched 2026-04-08 01:54:55
View on GitHub
Comments
1
Participants
2
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
commented ×1

Setting plugins.allow in openclaw.json to a non-empty array silently blocks all stock/bundled channel plugins — including Discord, Signal, and others — unless they are explicitly listed. There is no warning during openclaw doctor or at gateway startup to indicate that channels have been dropped.

Error Message

  1. Result: Discord (and all other stock channel plugins) silently stop working. No error in logs, no doctor warning.
  • Warn explicitly during openclaw doctor that named stock plugins will be blocked, OR

Root Cause

This caused a ~40 minute outage in production before the root cause was identified. openclaw doctor gave a clean bill of health throughout.

Fix Action

Workaround

Keep plugins.allow absent from config entirely unless you intend a full security lockdown and explicitly list every plugin you need. Do not rely on openclaw doctor to catch this.

Code Example

"plugins": {
     "allow": ["my-custom-plugin"],
     "entries": { ... }
   }
RAW_BUFFERClick to expand / collapse

Summary

Setting plugins.allow in openclaw.json to a non-empty array silently blocks all stock/bundled channel plugins — including Discord, Signal, and others — unless they are explicitly listed. There is no warning during openclaw doctor or at gateway startup to indicate that channels have been dropped.

Steps to Reproduce

  1. Add a custom workspace plugin and enable it via plugins.allow:
    "plugins": {
      "allow": ["my-custom-plugin"],
      "entries": { ... }
    }
  2. Run openclaw doctor — exits 0, Errors: 0
  3. Restart gateway
  4. Result: Discord (and all other stock channel plugins) silently stop working. No error in logs, no doctor warning.

Expected Behavior

plugins.allow should either:

  • Auto-include stock/bundled channel plugins, OR
  • Warn explicitly during openclaw doctor that named stock plugins will be blocked, OR
  • Document clearly that plugins.allow is a strict allowlist that overrides all defaults

Actual Behavior

Gateway starts without errors. Discord bot goes offline. No indication why until manually inspecting which plugins are actually loaded vs. configured.

Impact

This caused a ~40 minute outage in production before the root cause was identified. openclaw doctor gave a clean bill of health throughout.

Workaround

Keep plugins.allow absent from config entirely unless you intend a full security lockdown and explicitly list every plugin you need. Do not rely on openclaw doctor to catch this.

Environment

  • OpenClaw version: 2026.3.24 (confirmed still present on 2026.3.28)
  • Platform: Ubuntu 24.04 LTS, systemd service
  • Channel: Discord

extent analysis

Fix Plan

To resolve the issue with plugins.allow blocking stock/bundled channel plugins, follow these steps:

  • Explicitly include stock plugins: Modify the openclaw.json configuration to include the stock/bundled channel plugins in the plugins.allow array.
"plugins": {
  "allow": [
    "my-custom-plugin",
    "discord",
    "signal",
    // Add other required stock plugins here
  ],
  "entries": { ... }
}
  • Update documentation: Clearly document that plugins.allow is a strict allowlist that overrides all defaults, to prevent similar issues in the future.
  • Enhance openclaw doctor: Consider modifying openclaw doctor to warn explicitly when named stock plugins will be blocked due to the plugins.allow configuration.

Verification

To verify that the fix worked:

  1. Restart the gateway after updating the openclaw.json configuration.
  2. Check the gateway logs for any errors or warnings related to plugin loading.
  3. Test the Discord bot and other affected channel plugins to ensure they are working as expected.

Extra Tips

  • Always thoroughly test configuration changes before deploying them to production.
  • Consider implementing automated testing for openclaw doctor to catch similar issues in the future.
  • Review the OpenClaw documentation and configuration files regularly to ensure they are up-to-date and accurate.

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