Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

fix(openclaw-plugin): require OpenClaw 2026.5.27 (#3021)

Evof8ae35c274c7
diff --git a/examples/openclaw-plugin/INSTALL-AGENT.md b/examples/openclaw-plugin/INSTALL-AGENT.md
index 9286f7d1f..a20fc2d5f 100644
--- a/examples/openclaw-plugin/INSTALL-AGENT.md
+++ b/examples/openclaw-plugin/INSTALL-AGENT.md
@@ -153,11 +153,11 @@ openclaw --version
Requirements:
- Node.js >= 22
-- OpenClaw >= 2026.4.8
+- OpenClaw >= 2026.5.27
Version boundaries:
-- `2026.4.8` is the minimum supported OpenClaw version for the current `@openviking/openclaw-plugin` plugin.
+- `2026.5.27` is the minimum supported OpenClaw version for the current `@openviking/openclaw-plugin` plugin.
- `2026.5.3` starts requiring compiled JavaScript runtime output during package install when a plugin package declares TypeScript entries.
- `2026.5.4` and later no longer fall back to `.ts` source for installed/global plugin runtime loading when the compiled JavaScript output is missing; the plugin may be skipped.
- Published ClawHub packages are built before release and include `dist/*.js`, so normal users do not need to build locally.
diff --git a/examples/openclaw-plugin/INSTALL-ZH.md b/examples/openclaw-plugin/INSTALL-ZH.md
index 066e9bd41..fec14ce6a 100644
--- a/examples/openclaw-plugin/INSTALL-ZH.md
+++ b/examples/openclaw-plugin/INSTALL-ZH.md
@@ -27,13 +27,13 @@ openclaw plugins install clawhub:@openviking/openclaw-plugin
| 组件 | 要求 |
| --- | --- |
| Node.js | >= 22 |
-| OpenClaw | >= 2026.4.8 |
+| OpenClaw | >= 2026.5.27 |
插件以远程模式连接到已有的 OpenViking 服务。它不会帮你启动 OpenViking server。需要先启动 OpenViking,并保持服务运行,再把插件的 `baseUrl` 指向这个 HTTP 服务。默认本地地址是 `http://127.0.0.1:1933`。
OpenClaw 插件包版本边界:
-- `2026.4.8` 是当前插件支持的最低 OpenClaw 版本。
+- `2026.5.27` 是当前插件支持的最低 OpenClaw 版本。这个版本下限包含 2026 年 7 月 2 日 OpenClaw 安全公告批次的修复,包括 GHSA-8wg3-5mcm-fjq8 和 GHSA-83w9-h5wv-j9xm。
- `2026.5.3` 开始,OpenClaw 在安装包时会校验 TypeScript 插件入口是否有编译后的 JavaScript 产物。
- `2026.5.4` 及之后,已安装/全局插件如果缺少编译后的 JavaScript,运行时不再回退加载 `.ts` 源码,插件可能被跳过。
- 推荐的 `openclaw plugins install clawhub:@openviking/openclaw-plugin` 会安装已经发布并包含 `dist/*.js` 的插件包,普通用户不需要本地编译。
diff --git a/examples/openclaw-plugin/INSTALL.md b/examples/openclaw-plugin/INSTALL.md
index b99f0cf4b..51fb1b14c 100644
--- a/examples/openclaw-plugin/INSTALL.md
+++ b/examples/openclaw-plugin/INSTALL.md
@@ -27,13 +27,13 @@ openclaw plugins install clawhub:@openviking/openclaw-plugin
| Component | Required |
| --- | --- |
| Node.js | >= 22 |
-| OpenClaw | >= 2026.4.8 |
+| OpenClaw | >= 2026.5.27 |
The plugin connects to an existing OpenViking server. It does not start the OpenViking server for you. Start OpenViking first, keep it running, then point the plugin `baseUrl` at that HTTP service. The default local URL is `http://127.0.0.1:1933`.
OpenClaw plugin package boundaries:
-- `2026.4.8` is the minimum supported OpenClaw version for the current plugin.
+- `2026.5.27` is the minimum supported OpenClaw version for the current plugin. This floor includes the July 2, 2026 OpenClaw advisory batch fixes, including GHSA-8wg3-5mcm-fjq8 and GHSA-83w9-h5wv-j9xm.
- `2026.5.3` starts validating package installs so TypeScript plugin entries need compiled JavaScript output.
- `2026.5.4` and later stop falling back to `.ts` source for installed/global plugin runtime loading when compiled JavaScript is missing.
- The recommended `openclaw plugins install clawhub:@openviking/openclaw-plugin` path installs a published package that already includes `dist/*.js`.
diff --git a/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md b/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
index db0ac8989..748ca9867 100644
--- a/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
+++ b/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
@@ -393,7 +393,7 @@ bash install.sh --source tos --channel prod --version 2026.6.2
| 组件 | 要求 |
| --- | --- |
| Node.js | >= 22 |
-| OpenClaw | >= 2026.4.8 |
+| OpenClaw | >= 2026.5.27 |
| OpenViking Server | >= 0.4.1 |
兼容性声明在 `install-manifest.json` 的 `compatibility` 字段。
diff --git a/examples/openclaw-plugin/install-manifest.json b/examples/openclaw-plugin/install-manifest.json
index 70bff3805..c38cf077d 100644
--- a/examples/openclaw-plugin/install-manifest.json
+++ b/examples/openclaw-plugin/install-manifest.json
@@ -53,7 +53,7 @@
"pruneAfterBuild": true
},
"compatibility": {
- "minOpenclawVersion": "2026.4.8",
+ "minOpenclawVersion": "2026.5.27",
"recommendedOpenclawVersion": "2026.6.6",
"minOpenvikingVersion": "0.4.1",
"recommendedOpenvikingVersion": "0.4.1"
diff --git a/examples/openclaw-plugin/package-lock.json b/examples/openclaw-plugin/package-lock.json
index 20a9da9e8..b9f0dde30 100644
--- a/examples/openclaw-plugin/package-lock.json
+++ b/examples/openclaw-plugin/package-lock.json
@@ -19,7 +19,7 @@
"vitest": "^4.1.0"
},
"engines": {
- "openclaw": ">=2026.4.8"
+ "openclaw": ">=2026.5.27"
}
},
"node_modules/@emnapi/core": {
diff --git a/examples/openclaw-plugin/package.json b/examples/openclaw-plugin/package.json
index 412640c34..b53ef3016 100644
--- a/examples/openclaw-plugin/package.json
+++ b/examples/openclaw-plugin/package.json
@@ -47,7 +47,7 @@
"test:watch": "vitest"
},
"engines": {
- "openclaw": ">=2026.4.8"
+ "openclaw": ">=2026.5.27"
},
"dependencies": {
"@sinclair/typebox": "0.34.48",
@@ -69,12 +69,12 @@
],
"setupEntry": "./dist/commands/setup.js",
"compat": {
- "pluginApi": ">=2026.4.8",
- "minGatewayVersion": "2026.4.8"
+ "pluginApi": ">=2026.5.27",
+ "minGatewayVersion": "2026.5.27"
},
"build": {
- "openclawVersion": "2026.4.8",
- "pluginSdkVersion": "2026.4.8"
+ "openclawVersion": "2026.5.27",
+ "pluginSdkVersion": "2026.5.27"
}
},
"devDependencies": {
diff --git a/examples/openclaw-plugin/skills/install-openviking-memory/SKILL.md b/examples/openclaw-plugin/skills/install-openviking-memory/SKILL.md
index 76f59ef6e..a6b6f797f 100644
--- a/examples/openclaw-plugin/skills/install-openviking-memory/SKILL.md
+++ b/examples/openclaw-plugin/skills/install-openviking-memory/SKILL.md
@@ -91,8 +91,8 @@ openclaw --version
**If `openclaw` is missing:**
-> (CN) 你的系统没有安装 OpenClaw。请先安装 OpenClaw(>= 2026.4.8),然后再回来找我。
-> (EN) OpenClaw is not installed. Please install OpenClaw (>= 2026.4.8) first, then come back.
+> (CN) 你的系统没有安装 OpenClaw。请先安装 OpenClaw(>= 2026.5.27),然后再回来找我。
+> (EN) OpenClaw is not installed. Please install OpenClaw (>= 2026.5.27) first, then come back.
**Stop. Do NOT continue.**
@@ -736,7 +736,7 @@ Match against actual stderr / JSON `error` strings.
| Symptom (exact string) | Likely cause | Fix |
|---|---|---|
-| `command not found: openclaw` | OpenClaw not installed | Stop. Ask user to install OpenClaw >= 2026.4.8. |
+| `command not found: openclaw` | OpenClaw not installed | Stop. Ask user to install OpenClaw >= 2026.5.27. |
| `command not found: node` / `'node' is not recognized` | Node missing | Stop. Ask user to install Node.js >= 22. |
| `429` / `rate limit` / `Too Many Requests` from `plugins install` | ClawHub throttle | Switch to backup Path B (`ov-install`). |
| `not logged in` / `please log in` from `plugins install` | Anonymous user hit limit | Switch to backup Path B (`ov-install`). |
diff --git a/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts b/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
index f03abd306..1b7809a22 100644
--- a/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
+++ b/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
@@ -16,8 +16,13 @@ const manifest = JSON.parse(
const packageJson = JSON.parse(
readFileSync(resolve(pluginRoot, "package.json"), "utf8"),
) as {
+ engines?: { openclaw?: string };
version?: string;
files?: string[];
+ openclaw?: {
+ compat?: { pluginApi?: string; minGatewayVersion?: string };
+ build?: { openclawVersion?: string; pluginSdkVersion?: string };
+ };
scripts?: Record<string, string>;
};
const installManifest = JSON.parse(
@@ -127,16 +132,26 @@ describe("OpenClaw 5.5 package runtime contract", () => {
"package.json",
"openclaw.plugin.json",
]));
- expect(installManifest.compatibility?.minOpenclawVersion).toBe("2026.4.8");
+ expect(installManifest.compatibility?.minOpenclawVersion).toBe("2026.5.27");
});
it("declares compatibility floors and recommended versions, and keeps version fields in sync", () => {
expect(installManifest.compatibility).toMatchObject({
- minOpenclawVersion: "2026.4.8",
+ minOpenclawVersion: "2026.5.27",
recommendedOpenclawVersion: "2026.6.6",
minOpenvikingVersion: "0.4.1",
recommendedOpenvikingVersion: "0.4.1",
});
+ // OpenClaw installers read these package fields as host-version floor metadata.
+ expect(packageJson.engines?.openclaw).toBe(">=2026.5.27");
+ expect(packageJson.openclaw?.compat).toMatchObject({
+ pluginApi: ">=2026.5.27",
+ minGatewayVersion: "2026.5.27",
+ });
+ expect(packageJson.openclaw?.build).toMatchObject({
+ openclawVersion: "2026.5.27",
+ pluginSdkVersion: "2026.5.27",
+ });
// package.json version and install-manifest pluginVersion must stay identical.
expect(installManifest.pluginVersion).toBe(packageJson.version);
});