Skip to content

[Bug]: Local plugin(飞书 feishu) installation fails due to unhandled workspace: protocol in package.json #10941

@xsir317

Description

@xsir317

Summary

When installing a plugin from a local directory (e.g., openclaw plugins install ./extensions/feishu ) within the development environment, the installation fails during the npm install step. This is because the plugin's package.json contains pnpm specific workspace:* dependencies (like "openclaw": "workspace:*" ).

When the plugin is copied to the ~/.openclaw/extensions directory, it is no longer part of the workspace, and npm throws an EUNSUPPORTEDPROTOCOL error.

Error: Unsupported URL Type "workspace:": workspace:*

Suggested Workaround for Users For users encountering this, the --link flag can be used to avoid the copy and npm install steps, effectively using the already-built plugin in the source tree:

openclaw plugins install --link ./extensions/feishu

Proposed Documentation Update I suggest adding a note about the --link parameter in docs/channels/feishu.md to help users running from source or in Docker environments.

---- 给飞书用户 ----
如果你们通过源码安装 飞书插件失败, 你可以使用 --link 参数,
如果你只是想在 Docker 里用飞书插件,不需要把它“拷贝”到配置目录。你可以直接让 OpenClaw 加载镜像里已经存在的、完好的插件目录。
原理 :加上 --link 参数后,OpenClaw 只会在配置文件中记录该路径,而 不会执行拷贝和 npm install 操作 。由于 /app/extensions/feishu 已经在构建镜像时由 pnpm 处理好了依赖,它可以直接运行。

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