openclaw - 💡(How to fix) Fix Plugins/Extensions: Third-party memory plugin (openclaw-engram) installed via not discovered after v2026.3.31 externalization [1 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#60739Fetched 2026-04-08 02:47:47
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants

Root Cause

Possible Root Cause

Fix Action

Fix / Workaround

Workaround Attempts

Code Example

openclaw plugins install @joshuaswarren/openclaw-engram@latest

---

{
     "plugins": {
       "slots": { "memory": "openclaw-engram" },
       "entries": {
         "openclaw-engram": {
           "enabled": true,
           "config": { ... }
         }
       }
     }
   }
RAW_BUFFERClick to expand / collapse

Bug Description

After the v2026.3.31 plugin externalization changes, third-party plugins installed via openclaw plugins install to ~/.openclaw/extensions/ are not being discovered/loaded correctly when assigned to plugin slots.

Environment

  • OpenClaw version: 2026.4.2
  • OS: Linux (Ubuntu)
  • Node: v24.14.0

Steps to Reproduce

  1. Install a third-party memory plugin:

    openclaw plugins install @joshuaswarren/openclaw-engram@latest
  2. Plugin installs successfully to ~/.openclaw/extensions/openclaw-engram/

  3. Configure the plugin in openclaw.json:

    {
      "plugins": {
        "slots": { "memory": "openclaw-engram" },
        "entries": {
          "openclaw-engram": {
            "enabled": true,
            "config": { ... }
          }
        }
      }
    }
  4. Restart gateway: openclaw gateway restart

  5. Check logs - plugin shows initialization but with old bundled code, not extension code

Expected Behavior

The extension at ~/.openclaw/extensions/openclaw-engram/ should be loaded and used for the memory slot, with its version (9.1.29) and fixes.

Actual Behavior

  • Logs show subsystem path ~/.nvm/.../openclaw/dist/subsystem-*.js is used instead
  • Extension code is not loaded
  • The v2026.3.31 release notes mention: "Plugin SDK: Deprecate the legacy provider compat subpaths plus the older bundled provider setup"
  • The v2026.4.1-beta.1 fix mentions: "Restore externalized bundled plugin runtime dependency staging" but this appears to only apply to bundled plugins, not user-installed extensions

Investigation Findings

  1. Extension is properly installed at ~/.openclaw/extensions/openclaw-engram/ with correct openclaw.plugin.json and package.json (v9.1.29)
  2. No openclaw-engram exists in ~/.nvm/.../openclaw/dist/extensions/ (bundled)
  3. Config plugins.slots.memory: "openclaw-engram" should resolve to extension
  4. The subsystem loader appears to use bundled code path regardless of slot assignment
  5. Extension has fixes from March 27, 2026 (issues #310, #311 in engram repo) that are NOT in bundled version

Related Issues

  • #45287 - Plugin discovery/validation issues during update
  • #56968 - Third-party memory plugins show "unavailable" status (cosmetic, but related plugin discovery)
  • #57011 - Missing memory-tool.runtime dist chunk

Workaround Attempts

  1. Updated resolvedVersion, resolvedSpec, integrity in openclaw.json to match extension version - no effect
  2. Verified extension has correct plugin manifest - no effect
  3. Enabled/disabled plugin - no effect
  4. Gateway restart - no effect

Possible Root Cause

After v2026.3.31 externalization:

  • Bundled plugins are staged from dist/plugins/ or dist/extensions/
  • User-installed extensions in ~/.openclaw/extensions/ may not be included in the discovery path
  • The slot resolver may only check bundled plugin registry, not extension directory

Suggested Fix

Ensure extension discovery path includes ~/.openclaw/extensions/ for slot resolution, similar to how bundled plugins are discovered after the v2026.4.1-beta.1 fix.

Severity

Medium - Memory functionality works with bundled version, but users cannot upgrade memory plugins with newer fixes without waiting for OpenClaw bundled version updates.

extent analysis

TL;DR

The issue can be resolved by ensuring the extension discovery path includes ~/.openclaw/extensions/ for slot resolution, allowing user-installed extensions to be loaded correctly.

Guidance

  • Verify that the openclaw.json configuration file correctly references the installed extension in the plugins section, specifically the slots and entries configurations.
  • Check the extension's openclaw.plugin.json and package.json files for correctness and version consistency (v9.1.29 in this case).
  • Investigate modifying the slot resolver to include the ~/.openclaw/extensions/ directory in its discovery path, potentially similar to how bundled plugins are handled after the v2026.4.1-beta.1 fix.
  • Consider testing with a different extension or plugin to isolate if the issue is specific to the openclaw-engram plugin or a more general problem with extension loading.

Example

No specific code example is provided due to the lack of direct code references in the issue, but ensuring the openclaw.json is correctly formatted, such as:

{
  "plugins": {
    "slots": { "memory": "openclaw-engram" },
    "entries": {
      "openclaw-engram": {
        "enabled": true,
        "config": { ... }
      }
    }
  }
}

is crucial for the plugin system to recognize and load the extension.

Notes

The issue seems to stem from changes in plugin externalization and discovery after version v2026.3.31, affecting how user-installed extensions are loaded into the system. The provided steps and configurations suggest a specific problem with the openclaw-engram extension, but the root cause might be more general, affecting other extensions as well.

Recommendation

Apply a workaround by manually ensuring the extension directory is included in the plugin discovery path, as this seems to be the most direct approach to resolving the issue given the current information. This might involve configuration changes or adjustments to how the slot resolver functions, potentially requiring updates to the OpenClaw configuration or the plugin itself.

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 Plugins/Extensions: Third-party memory plugin (openclaw-engram) installed via not discovered after v2026.3.31 externalization [1 participants]