Skip to content

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

chore(openclaw-plugin): release 2026.6.18 and raise OpenViking floor to 0.4.1 (#2705)

LinQiang391b55d37916072
diff --git a/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md b/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
index 766811fb0..7d4ef9219 100644
--- a/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
+++ b/examples/openclaw-plugin/docs/openviking-openclaw-plugin-guide.md
@@ -394,9 +394,9 @@ bash install.sh --source tos --channel prod --version 2026.6.2
| --- | --- |
| Node.js | >= 22 |
| OpenClaw | >= 2026.4.8 |
-| OpenViking Server | >= 0.2.9 |
+| OpenViking Server | >= 0.4.1 |
-兼容性声明在 `install-manifest.json:43`。
+兼容性声明在 `install-manifest.json` 的 `compatibility` 字段。
### 7.2 启动 OpenViking Server
diff --git a/examples/openclaw-plugin/install-manifest.json b/examples/openclaw-plugin/install-manifest.json
index 4b9396585..23a8c6969 100644
--- a/examples/openclaw-plugin/install-manifest.json
+++ b/examples/openclaw-plugin/install-manifest.json
@@ -1,6 +1,6 @@
{
"manifestVersion": "1.0",
- "pluginVersion": "2026.6.11",
+ "pluginVersion": "2026.6.18",
"plugin": {
"id": "openviking",
"kind": "context-engine",
@@ -32,7 +32,8 @@
"tsconfig.json",
"tsconfig.build.json",
"package.json",
- "openclaw.plugin.json"
+ "openclaw.plugin.json",
+ "install-manifest.json"
],
"optional": [
"package-lock.json",
@@ -52,6 +53,8 @@
},
"compatibility": {
"minOpenclawVersion": "2026.4.8",
- "minOpenvikingVersion": "0.2.9"
+ "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 5eb899d2f..20a9da9e8 100644
--- a/examples/openclaw-plugin/package-lock.json
+++ b/examples/openclaw-plugin/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@openviking/openclaw-plugin",
- "version": "2026.6.11",
+ "version": "2026.6.18",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@openviking/openclaw-plugin",
- "version": "2026.6.11",
+ "version": "2026.6.18",
"license": "MIT",
"dependencies": {
"@sinclair/typebox": "0.34.48",
diff --git a/examples/openclaw-plugin/package.json b/examples/openclaw-plugin/package.json
index bee1ee326..412640c34 100644
--- a/examples/openclaw-plugin/package.json
+++ b/examples/openclaw-plugin/package.json
@@ -1,6 +1,6 @@
{
"name": "@openviking/openclaw-plugin",
- "version": "2026.6.11",
+ "version": "2026.6.18",
"displayName": "OpenViking",
"description": "OpenClaw context-engine plugin — OpenViking AI memory, long-term memory, knowledge base, semantic search, RAG, context engine. 长期记忆 · 知识库 · 语义检索 · 上下文引擎",
"type": "module",
diff --git a/examples/openclaw-plugin/scripts/generate-release-manifest.mjs b/examples/openclaw-plugin/scripts/generate-release-manifest.mjs
index 4a802712a..81d75ccf0 100755
--- a/examples/openclaw-plugin/scripts/generate-release-manifest.mjs
+++ b/examples/openclaw-plugin/scripts/generate-release-manifest.mjs
@@ -42,6 +42,32 @@ function sha256(path) {
return createHash("sha256").update(readFileSync(path)).digest("hex");
}
+// install-manifest.json is the single source of truth for compatibility floors and
+// recommended versions. The published release manifest derives them from it so the
+// two manifests can never declare divergent compatibility.
+const installManifestUrl = new URL("../install-manifest.json", import.meta.url);
+
+function readInstallCompatibility() {
+ let parsed;
+ try {
+ parsed = JSON.parse(readFileSync(installManifestUrl, "utf8"));
+ } catch (error) {
+ die(`Unable to read install-manifest.json compatibility: ${error.message}`);
+ }
+ const compat = parsed.compatibility ?? {};
+ for (const field of [
+ "minOpenclawVersion",
+ "recommendedOpenclawVersion",
+ "minOpenvikingVersion",
+ "recommendedOpenvikingVersion",
+ ]) {
+ if (!compat[field]) {
+ die(`install-manifest.json compatibility.${field} is required`);
+ }
+ }
+ return compat;
+}
+
const environment = readOption("--env");
const version = readOption("--version");
const tag = readOption("--tag");
@@ -72,6 +98,7 @@ if (artifacts.length === 0) {
}
const releaseNotes = notesPath ? readFileSync(notesPath, "utf8") : "";
+const installCompatibility = readInstallCompatibility();
const artifactEntries = artifacts.map((path) => {
const name = basename(path);
const stats = statSync(path);
@@ -112,9 +139,12 @@ const manifest = {
releaseNotes,
},
compatibility: {
- minOpenclawVersion: "2026.4.8",
- minGatewayVersion: "2026.4.8",
+ minOpenclawVersion: installCompatibility.minOpenclawVersion,
+ recommendedOpenclawVersion: installCompatibility.recommendedOpenclawVersion,
+ minGatewayVersion: installCompatibility.minOpenclawVersion,
minNodeVersion: "22.0.0",
+ minOpenvikingVersion: installCompatibility.minOpenvikingVersion,
+ recommendedOpenvikingVersion: installCompatibility.recommendedOpenvikingVersion,
},
artifacts: artifactEntries,
checksums: {
diff --git a/examples/openclaw-plugin/setup-helper/install.js b/examples/openclaw-plugin/setup-helper/install.js
index 78eecf734..652e7aca1 100755
--- a/examples/openclaw-plugin/setup-helper/install.js
+++ b/examples/openclaw-plugin/setup-helper/install.js
@@ -390,7 +390,7 @@ function printHelp() {
console.log(" node install.js --current-version");
console.log("");
console.log(" # Install a specific release version");
- console.log(" node install.js --plugin-version=2026.5.8");
+ console.log(" node install.js --plugin-version=2026.6.18");
console.log("");
console.log(" # Install from a fork repository");
console.log(" node install.js --github-repo=yourname/OpenViking --plugin-version=dev-branch");
@@ -1859,6 +1859,96 @@ async function downloadPluginFile(destDir, fileName, url, required, index, total
process.exit(1);
}
+function githubContentsUrl(pluginDir, fileName) {
+ const path = `examples/${pluginDir}/${fileName}`.replace(/\/+$/u, "");
+ const encodedPath = path.split("/").map((part) => encodeURIComponent(part)).join("/");
+ return `https://api.github.com/repos/${REPO}/contents/${encodedPath}?ref=${encodeURIComponent(PLUGIN_VERSION)}`;
+}
+
+async function fetchGitHubDirectoryEntries(pluginDir, dirName, required) {
+ const maxRetries = 3;
+ const url = githubContentsUrl(pluginDir, dirName);
+ let lastStatus = 0;
+
+ for (let attempt = 1; attempt <= maxRetries; attempt++) {
+ try {
+ const response = await fetch(url, { headers: { "User-Agent": "openviking-setup-helper" } });
+ lastStatus = response.status;
+ if (response.ok) {
+ const json = await response.json();
+ if (Array.isArray(json)) return json;
+ lastStatus = 0;
+ } else if (!required && response.status === 404) {
+ return null;
+ }
+ } catch {
+ lastStatus = 0;
+ }
+
+ if (attempt < maxRetries) {
+ await new Promise((resolve) => setTimeout(resolve, 2000));
+ }
+ }
+
+ if (!required) {
+ err(tr(
+ `Optional directory failed after ${maxRetries} retries (HTTP ${lastStatus || "network"}): ${url}`,
+ `可选目录已重试 ${maxRetries} 次仍失败(HTTP ${lastStatus || "网络错误"}): ${url}`,
+ ));
+ process.exit(1);
+ }
+
+ err(tr(
+ `Directory download failed after ${maxRetries} retries (HTTP ${lastStatus || "network"}): ${url}`,
+ `目录下载失败(已重试 ${maxRetries} 次,HTTP ${lastStatus || "网络错误"}): ${url}`,
+ ));
+ process.exit(1);
+}
+
+async function collectGitHubDirectoryFiles(pluginDir, dirName, required) {
+ const entries = await fetchGitHubDirectoryEntries(pluginDir, dirName, required);
+ if (!entries) return [];
+
+ const prefix = `examples/${pluginDir}/`;
+ const files = [];
+ for (const entry of entries) {
+ if (entry?.type === "file" && entry.download_url) {
+ const relativePath = String(entry.path || "").startsWith(prefix)
+ ? String(entry.path).slice(prefix.length)
+ : `${dirName}${entry.name}`;
+ files.push({ fileName: relativePath, url: entry.download_url });
+ continue;
+ }
+
+ if (entry?.type === "dir" && entry.path) {
+ const relativeDir = String(entry.path).startsWith(prefix)
+ ? String(entry.path).slice(prefix.length)
+ : `${dirName}${entry.name}/`;
+ files.push(...await collectGitHubDirectoryFiles(pluginDir, `${relativeDir}/`, required));
+ }
+ }
+
+ return files;
+}
+
+async function downloadPluginDirectory(destDir, pluginDir, dirName, required, index, total) {
+ process.stdout.write(` [${index}/${total}] ${dirName} `);
+ const files = await collectGitHubDirectoryFiles(pluginDir, dirName, required);
+ if (files.length === 0) {
+ console.log(required ? " empty" : tr(" skip", " 跳过"));
+ if (!required) return;
+ err(tr(`Required directory is empty or unavailable: ${dirName}`, `必需目录为空或不可用: ${dirName}`));
+ process.exit(1);
+ }
+ console.log(` OK (${files.length} files)`);
+
+ let fileIndex = 0;
+ for (const file of files) {
+ fileIndex++;
+ await downloadPluginFile(destDir, file.fileName, file.url, required, `${index}.${fileIndex}`, total);
+ }
+}
+
function runtimeOutputCandidatesForEntry(entry) {
const normalized = String(entry || "").replace(/\\/g, "/").replace(/^\.\//, "");
if (!normalized.endsWith(".ts")) {
@@ -1998,6 +2088,10 @@ async function downloadPlugin(destDir) {
for (const name of resolvedFilesRequired) {
if (!name) continue;
i++;
+ if (name.endsWith("/")) {
+ await downloadPluginDirectory(destDir, pluginDir, name, true, i, total);
+ continue;
+ }
const url = `${ghRaw}/examples/${pluginDir}/${name}`;
await downloadPluginFile(destDir, name, url, true, i, total);
}
@@ -2006,6 +2100,10 @@ async function downloadPlugin(destDir) {
for (const name of resolvedFilesOptional) {
if (!name) continue;
i++;
+ if (name.endsWith("/")) {
+ await downloadPluginDirectory(destDir, pluginDir, name, false, i, total);
+ continue;
+ }
const url = `${ghRaw}/examples/${pluginDir}/${name}`;
await downloadPluginFile(destDir, name, url, false, i, total);
}
diff --git a/examples/openclaw-plugin/setup-helper/package.json b/examples/openclaw-plugin/setup-helper/package.json
index b97239baf..a110ea2b9 100644
--- a/examples/openclaw-plugin/setup-helper/package.json
+++ b/examples/openclaw-plugin/setup-helper/package.json
@@ -1,6 +1,6 @@
{
"name": "openclaw-openviking-setup-helper",
- "version": "0.3.1",
+ "version": "2026.6.18",
"description": "Setup helper for installing OpenViking memory plugin into OpenClaw",
"type": "module",
"bin": {
diff --git a/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts b/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
index 1248d28c2..f03abd306 100644
--- a/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
+++ b/examples/openclaw-plugin/tests/ut/manifest-contracts.test.ts
@@ -16,13 +16,20 @@ const manifest = JSON.parse(
const packageJson = JSON.parse(
readFileSync(resolve(pluginRoot, "package.json"), "utf8"),
) as {
+ version?: string;
files?: string[];
scripts?: Record<string, string>;
};
const installManifest = JSON.parse(
readFileSync(resolve(pluginRoot, "install-manifest.json"), "utf8"),
) as {
- compatibility?: { minOpenclawVersion?: string };
+ pluginVersion?: string;
+ compatibility?: {
+ minOpenclawVersion?: string;
+ recommendedOpenclawVersion?: string;
+ minOpenvikingVersion?: string;
+ recommendedOpenvikingVersion?: string;
+ };
files?: { required?: string[]; optional?: string[] };
npm?: {
build?: boolean;
@@ -122,4 +129,15 @@ describe("OpenClaw 5.5 package runtime contract", () => {
]));
expect(installManifest.compatibility?.minOpenclawVersion).toBe("2026.4.8");
});
+
+ it("declares compatibility floors and recommended versions, and keeps version fields in sync", () => {
+ expect(installManifest.compatibility).toMatchObject({
+ minOpenclawVersion: "2026.4.8",
+ recommendedOpenclawVersion: "2026.6.6",
+ minOpenvikingVersion: "0.4.1",
+ recommendedOpenvikingVersion: "0.4.1",
+ });
+ // package.json version and install-manifest pluginVersion must stay identical.
+ expect(installManifest.pluginVersion).toBe(packageJson.version);
+ });
});
diff --git a/examples/openclaw-plugin/tests/ut/tos-release-contract.test.ts b/examples/openclaw-plugin/tests/ut/tos-release-contract.test.ts
index d2fbaee34..2fc89503c 100644
--- a/examples/openclaw-plugin/tests/ut/tos-release-contract.test.ts
+++ b/examples/openclaw-plugin/tests/ut/tos-release-contract.test.ts
@@ -68,6 +68,18 @@ describe("TOS release and single installer contract", () => {
expect(manifest.artifacts.every((artifact: { sha256: string; size: number }) => artifact.sha256.length === 64 && artifact.size > 0)).toBe(true);
expect(checksums).toContain("openviking.tgz");
expect(checksums).toContain("install.sh");
+
+ // The release manifest must derive its compatibility floors/recommended
+ // versions from install-manifest.json so the two manifests never diverge.
+ const installManifest = JSON.parse(readText("install-manifest.json"));
+ expect(manifest.compatibility).toMatchObject({
+ minOpenclawVersion: installManifest.compatibility.minOpenclawVersion,
+ recommendedOpenclawVersion: installManifest.compatibility.recommendedOpenclawVersion,
+ minOpenvikingVersion: installManifest.compatibility.minOpenvikingVersion,
+ recommendedOpenvikingVersion: installManifest.compatibility.recommendedOpenvikingVersion,
+ });
+ expect(manifest.compatibility.minGatewayVersion).toBe(installManifest.compatibility.minOpenclawVersion);
+ expect(manifest.compatibility.minNodeVersion).toBe("22.0.0");
});
it("generates environment-specific manifest metadata for non-prod releases", () => {