openclaw - 💡(How to fix) Fix skill-workshop: crashes with Matrix room IDs — 'Bundled plugin dirName must be a single directory' [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#77636Fetched 2026-05-06 06:23:38
View on GitHub
Comments
1
Participants
2
Timeline
1
Reactions
2
Timeline (top)
commented ×1

When the skill-workshop plugin is enabled and the agent is used via a Matrix DM, the plugin throws an error on every agent turn:

Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

This error fires on both the main lane and the session:agent:main:main lane after every turn. The skill reviewer is also skipped:

[plugins] skill-workshop: reviewer skipped: Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

Error Message

Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

Root Cause

When the skill-workshop plugin is enabled and the agent is used via a Matrix DM, the plugin throws an error on every agent turn:

Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

This error fires on both the main lane and the session:agent:main:main lane after every turn. The skill reviewer is also skipped:

[plugins] skill-workshop: reviewer skipped: Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

Fix Action

Workaround

Disable skill-workshop in plugins.entries:

{ "skill-workshop": { "enabled": false } }

Code Example

Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

---

[plugins] skill-workshop: reviewer skipped: Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

---

{ "skill-workshop": { "enabled": false } }
RAW_BUFFERClick to expand / collapse

Summary

When the skill-workshop plugin is enabled and the agent is used via a Matrix DM, the plugin throws an error on every agent turn:

Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

This error fires on both the main lane and the session:agent:main:main lane after every turn. The skill reviewer is also skipped:

[plugins] skill-workshop: reviewer skipped: Error: Bundled plugin dirName must be a single directory: room:!dujllatvudbbdkaqkr:matrix.org

Impact

  • The repeated errors appear to prevent clean gateway shutdown — the gateway hangs on drain (draining 2 active task(s) and 1 active embedded run(s)) for up to 300 seconds before force-killing
  • This caused in-flight agent turns to be replayed on restart, resulting in duplicate replies being sent to the user (both in Matrix and the TUI)
  • Workaround: disable skill-workshop entirely

Steps to Reproduce

  1. Enable the skill-workshop plugin (plugins.entries.skill-workshop.enabled: true)
  2. Configure a Matrix DM channel with E2EE
  3. Send any message via Matrix DM
  4. Observe the error in gateway logs after every turn

Environment

  • OpenClaw: 2026.5.2 (reproduced), updated to 2026.5.3-1 (not re-tested with skill-workshop enabled)
  • Matrix channel plugin, E2EE enabled
  • session.dmScope: "main"
  • Linux Mint 22.3 / Ubuntu 24.04 base

Expected Behavior

skill-workshop should either handle Matrix room IDs gracefully in the session context, or skip cleanly when the session context is not a filesystem-compatible path.

Workaround

Disable skill-workshop in plugins.entries:

{ "skill-workshop": { "enabled": false } }

extent analysis

TL;DR

The skill-workshop plugin needs to handle Matrix room IDs as a single directory to prevent errors and duplicate replies.

Guidance

  • Verify that the skill-workshop plugin is correctly configured to handle non-filesystem paths, such as Matrix room IDs.
  • Check the plugin's documentation for any specific settings or workarounds for Matrix DM channels with E2EE.
  • Consider modifying the session.dmScope setting to a value that is compatible with the skill-workshop plugin's expectations.
  • Test the skill-workshop plugin with a different dmScope setting to see if it resolves the issue.

Example

No code snippet is provided as the issue is related to plugin configuration and compatibility.

Notes

The provided workaround of disabling the skill-workshop plugin may not be desirable, and a more permanent solution should be explored. The issue may be related to the plugin's handling of non-filesystem paths, and further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Disable the skill-workshop plugin until a more permanent solution is found, as it prevents clean gateway shutdown and causes duplicate replies.

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