Skip to content

Matrix plugin ships workspace:* dependency, breaks npm install #12853

@michaelgtallia

Description

@michaelgtallia

Bug

The published @openclaw/matrix plugin tarball contains "openclaw": "workspace:*" in its package.json dependencies. This is a pnpm workspace protocol reference that only resolves inside the monorepo.

When users install the plugin via openclaw plugins install @openclaw/matrix, it runs npm install in the extracted directory, which fails:

npm error code EUNSUPPORTEDPROTOCOL
npm error Unsupported URL Type "workspace:": workspace:*

This breaks Matrix connectivity on every update, since the plugin gets re-extracted with the unresolved workspace reference.

Expected

workspace:* should be resolved to a concrete version range (e.g. "openclaw": "*" or "openclaw": "^2026.2.9") before publishing to npm. Both pnpm and npm handle this automatically during pnpm publish / npm publish when configured correctly.

Workaround

Manually replace "openclaw": "workspace:*" with "openclaw": "*" and run bun install (bun handles workspace: gracefully) or npm install.

Environment

  • openclaw 2026.2.9
  • macOS, npm global install
  • skills.install.nodeManager: "bun" (not respected for plugin installs)

Suggestion

  1. Fix the publish pipeline so workspace: refs are resolved in the tarball
  2. Consider respecting skills.install.nodeManager for plugin installs too

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions