Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
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.mdindex 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 Serverdiff --git a/examples/openclaw-plugin/install-manifest.json b/examples/openclaw-plugin/install-manifest.jsonindex 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.jsonindex 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.jsonindex 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.mjsindex 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.jsindex 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, totalprocess.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.jsonindex 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.tsindex 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.tsindex 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", () => {