[Bug] Plugin requires API 2026.3.24 but OpenClaw 2026.3.28 is installed

[AlexZhou19871030]

问题描述

安装 graph-memory v1.x 时出现版本不相容错误：

Plugin "graph-memory" requires plugin API 2026.3.24, but this OpenClaw runtime exposes 2026.3.28.

环境信息

• OpenClaw 版本: 2026.3.28

• Node.js: v22.22.0
• 安装方式: pnpm openclaw plugins install graph-memory

复现步骤

1. 运行 pnpm openclaw plugins install graph-memory
2. 出现错误： Plugin requires API 2026.3.24

期望

能够兼容 OpenClaw 2026.3.28 版本，或提供升级指导。

其他信息

• 已查看 v2.0.0 Pro（Neo4j版），但对于只想使用 SQLite 版本的我来说太大
• 是否可以发布针寻 2026.3.28 API 编译的版本?

[JiwaniZakir]

The error indicates the plugin's manifest declares a hard requirement on API version 2026.3.24, and the OpenClaw runtime is performing a strict equality check rather than a semver-compatible range check against the installed 2026.3.28. The root cause is likely in the plugin's package.json or manifest file where the pluginApi (or equivalent) field is pinned to an exact version instead of a range like >=2026.3.24. Rebuilding or patching the manifest to use >=2026.3.24 (or ^2026.3.24 if the runtime supports caret ranges) should resolve the incompatibility without requiring a full new release — assuming no breaking changes were introduced between 2026.3.24 and 2026.3.28 in the OpenClaw plugin API surface.

[TriDefender]

The error indicates the plugin's manifest declares a hard requirement on API version 2026.3.24, and the OpenClaw runtime is performing a strict equality check rather than a semver-compatible range check against the installed 2026.3.28. The root cause is likely in the plugin's package.json or manifest file where the pluginApi (or equivalent) field is pinned to an exact version instead of a range like >=2026.3.24. Rebuilding or patching the manifest to use >=2026.3.24 (or ^2026.3.24 if the runtime supports caret ranges) should resolve the incompatibility without requiring a full new release — assuming no breaking changes were introduced between 2026.3.24 and 2026.3.28 in the OpenClaw plugin API surface.

But there's breaking changes, note:

14:17:45+00:00 (node:26399) [OPENCLAW_EXTENSION_API_DEPRECATED] Warning: openclaw/extension-api is deprecated. Migrate to api.runtime.agent.* or focused openclaw/plugin-sdk/<subpath> imports. See https://docs.openclaw.ai/plugins/sdk-migration
This compatibility bridge is temporary. Bundled plugins should use the injected plugin runtime instead of importing host-side agent helpers directly. Migration guide: https://docs.openclaw.ai/plugins/sdk-migration
(Use `node --trace-warnings ...` to show where the warning was created)