openclaw-openviking-setup-helper 0.2.9-dev.0 → 0.2.9-dev.1

package/install.js

@@ -23,9 +23,9 @@
  */
 
 import { spawn } from "node:child_process";
-import { cp, mkdir, rm, writeFile } from "node:fs/promises";
-import { existsSync, readdirSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
+import { cp, mkdir, rm, writeFile } from "node:fs/promises";
+import { existsSync, readdirSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 
@@ -35,7 +35,7 @@ let REPO = process.env.REPO || "volcengine/OpenViking";
 // PLUGIN_VERSION takes precedence over BRANCH (legacy)
 let PLUGIN_VERSION = process.env.PLUGIN_VERSION || process.env.BRANCH || "main";
 const NPM_REGISTRY = process.env.NPM_REGISTRY || "https://registry.npmmirror.com";
-const PIP_INDEX_URL = process.env.PIP_INDEX_URL || "https://mirrors.volces.com/pypi/simple/";
+const PIP_INDEX_URL = process.env.PIP_INDEX_URL || "https://mirrors.volces.com/pypi/simple/";
 
 const IS_WIN = process.platform === "win32";
 const HOME = process.env.HOME || process.env.USERPROFILE || "";
@@ -66,8 +66,8 @@ const FALLBACK_CURRENT = {
   id: "openviking",
   kind: "context-engine",
   slot: "contextEngine",
-  required: ["index.ts", "context-engine.ts", "config.ts", "client.ts", "process-manager.ts", "memory-ranking.ts", "text-utils.ts", "session-transcript-repair.ts", "tool-call-id.ts", "openclaw.plugin.json", "package.json", "tsconfig.json"],
-  optional: ["package-lock.json", ".gitignore"],
+  required: ["index.ts", "config.ts", "openclaw.plugin.json", "package.json"],
+  optional: ["context-engine.ts", "client.ts", "process-manager.ts", "memory-ranking.ts", "text-utils.ts", "session-transcript-repair.ts", "tool-call-id.ts", "tsconfig.json", "package-lock.json", ".gitignore"],
 };
 
 // Resolved plugin config (set by resolvePluginConfig)
@@ -75,11 +75,11 @@ let resolvedPluginDir = "";
 let resolvedPluginId = "";
 let resolvedPluginKind = "";
 let resolvedPluginSlot = "";
-let resolvedFilesRequired = [];
-let resolvedFilesOptional = [];
-let resolvedNpmOmitDev = true;
-let resolvedMinOpenclawVersion = "";
-let resolvedMinOpenvikingVersion = "";
+let resolvedFilesRequired = [];
+let resolvedFilesOptional = [];
+let resolvedNpmOmitDev = true;
+let resolvedMinOpenclawVersion = "";
+let resolvedMinOpenvikingVersion = "";
 
 let installYes = process.env.OPENVIKING_INSTALL_YES === "1";
 let langZh = false;
@@ -296,8 +296,19 @@ function question(prompt, defaultValue = "") {
   });
 }
 
+async function resolveAbsoluteCommand(cmd) {
+  if (cmd.startsWith("/") || (IS_WIN && /^[A-Za-z]:[/\\]/.test(cmd))) return cmd;
+  if (IS_WIN) {
+    const r = await runCapture("where", [cmd], { shell: true });
+    return r.out.split(/\r?\n/)[0]?.trim() || cmd;
+  }
+  const r = await runCapture("which", [cmd], { shell: false });
+  return r.out.trim() || cmd;
+}
+
 async function checkPython() {
-  const py = process.env.OPENVIKING_PYTHON || (IS_WIN ? "python" : "python3");
+  const raw = process.env.OPENVIKING_PYTHON || (IS_WIN ? "python" : "python3");
+  const py = await resolveAbsoluteCommand(raw);
   const result = await runCapture(py, ["-c", "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"]);
   if (result.code !== 0 || !result.out) {
     return {
@@ -452,7 +463,7 @@ async function checkOpenClaw() {
 }
 
 // Compare versions: returns true if v1 >= v2
-function versionGte(v1, v2) {
+function versionGte(v1, v2) {
   const parseVersion = (v) => {
     const cleaned = v.replace(/^v/, "").replace(/-.*$/, "");
     const parts = cleaned.split(".").map((p) => Number.parseInt(p, 10) || 0);
@@ -463,12 +474,12 @@ function versionGte(v1, v2) {
   const [b1, b2, b3] = parseVersion(v2);
   if (a1 !== b1) return a1 > b1;
   if (a2 !== b2) return a2 > b2;
-  return a3 >= b3;
-}
-
-function isSemverLike(value) {
-  return /^v?\d+(\.\d+){1,2}$/.test(value);
-}
+  return a3 >= b3;
+}
+
+function isSemverLike(value) {
+  return /^v?\d+(\.\d+){1,2}$/.test(value);
+}
 
 // Detect OpenClaw version
 async function detectOpenClawVersion() {
@@ -547,19 +558,40 @@ async function resolvePluginConfig() {
 
   resolvedPluginDir = pluginDir;
 
-  if (manifestData) {
-    resolvedPluginId = manifestData.plugin?.id || "";
-    resolvedPluginKind = manifestData.plugin?.kind || "";
-    resolvedPluginSlot = manifestData.plugin?.slot || "";
-    resolvedMinOpenclawVersion = manifestData.compatibility?.minOpenclawVersion || "";
-    resolvedMinOpenvikingVersion = manifestData.compatibility?.minOpenvikingVersion || "";
-    resolvedNpmOmitDev = manifestData.npm?.omitDev !== false;
-    resolvedFilesRequired = manifestData.files?.required || [];
-    resolvedFilesOptional = manifestData.files?.optional || [];
-  } else {
-    // Use fallback config
-    const fallback = pluginDir === "openclaw-memory-plugin" ? FALLBACK_LEGACY : FALLBACK_CURRENT;
-    resolvedPluginDir = fallback.dir;
+  if (manifestData) {
+    resolvedPluginId = manifestData.plugin?.id || "";
+    resolvedPluginKind = manifestData.plugin?.kind || "";
+    resolvedPluginSlot = manifestData.plugin?.slot || "";
+    resolvedMinOpenclawVersion = manifestData.compatibility?.minOpenclawVersion || "";
+    resolvedMinOpenvikingVersion = manifestData.compatibility?.minOpenvikingVersion || "";
+    resolvedNpmOmitDev = manifestData.npm?.omitDev !== false;
+    resolvedFilesRequired = manifestData.files?.required || [];
+    resolvedFilesOptional = manifestData.files?.optional || [];
+  } else {
+    // No manifest — determine plugin identity by package.json name
+    let fallbackKey = pluginDir === "openclaw-memory-plugin" ? "legacy" : "current";
+    let compatVer = "";
+
+    const pkgJson = await tryFetch(`${ghRaw}/examples/${pluginDir}/package.json`);
+    if (pkgJson) {
+      try {
+        const pkg = JSON.parse(pkgJson);
+        const pkgName = pkg.name || "";
+        if (pkgName && pkgName !== "@openclaw/openviking") {
+          fallbackKey = "legacy";
+          info(tr(`Detected legacy plugin by package name: ${pkgName}`, `通过 package.json 名称检测到旧版插件: ${pkgName}`));
+        } else if (pkgName) {
+          fallbackKey = "current";
+        }
+        compatVer = (pkg.engines?.openclaw || "").replace(/^>=?\s*/, "").trim();
+        if (compatVer) {
+          info(tr(`Read minOpenclawVersion from package.json engines.openclaw: >=${compatVer}`, `从 package.json engines.openclaw 读取到最低版本: >=${compatVer}`));
+        }
+      } catch {}
+    }
+
+    const fallback = fallbackKey === "legacy" ? FALLBACK_LEGACY : FALLBACK_CURRENT;
+    resolvedPluginDir = pluginDir;
     resolvedPluginId = fallback.id;
     resolvedPluginKind = fallback.kind;
     resolvedPluginSlot = fallback.slot;
@@ -567,13 +599,24 @@ async function resolvePluginConfig() {
     resolvedFilesOptional = fallback.optional;
     resolvedNpmOmitDev = true;
 
-    if (pluginDir === "openclaw-plugin") {
-      resolvedMinOpenclawVersion = "3.7";
-    } else {
-      resolvedMinOpenclawVersion = "";
-    }
-    resolvedMinOpenvikingVersion = "";
-  }
+    // If no compatVer from package.json, try main branch manifest
+    if (!compatVer && PLUGIN_VERSION !== "main") {
+      const mainRaw = `https://raw.githubusercontent.com/${REPO}/main`;
+      const mainManifest = await tryFetch(`${mainRaw}/examples/openclaw-plugin/install-manifest.json`);
+      if (mainManifest) {
+        try {
+          const m = JSON.parse(mainManifest);
+          compatVer = m.compatibility?.minOpenclawVersion || "";
+          if (compatVer) {
+            info(tr(`Read minOpenclawVersion from main branch manifest: >=${compatVer}`, `从 main 分支 manifest 读取到最低版本: >=${compatVer}`));
+          }
+        } catch {}
+      }
+    }
+
+    resolvedMinOpenclawVersion = compatVer || "2026.3.7";
+    resolvedMinOpenvikingVersion = "";
+  }
 
   // Set plugin destination
   PLUGIN_DEST = join(OPENCLAW_DIR, "extensions", resolvedPluginId);
@@ -596,9 +639,9 @@ async function checkOpenClawCompatibility() {
   }
 
   // If user explicitly requested an old version, pass
-  if (PLUGIN_VERSION !== "main" && isSemverLike(PLUGIN_VERSION) && !versionGte(PLUGIN_VERSION, "v0.2.9")) {
-    return;
-  }
+  if (PLUGIN_VERSION !== "main" && isSemverLike(PLUGIN_VERSION) && !versionGte(PLUGIN_VERSION, "v0.2.9")) {
+    return;
+  }
 
   // Check compatibility
   if (!versionGte(ocVersion, resolvedMinOpenclawVersion)) {
@@ -610,32 +653,32 @@ async function checkOpenClawCompatibility() {
     bold(tr("Please choose one of the following options:", "请选择以下方案之一："));
     console.log("");
     console.log(`  ${tr("Option 1: Upgrade OpenClaw", "方案 1：升级 OpenClaw")}`);
-    console.log(`    npm update -g openclaw --registry ${NPM_REGISTRY}`);
+    console.log(`    npm update -g openclaw --registry ${NPM_REGISTRY}`);
     console.log("");
     console.log(`  ${tr("Option 2: Install legacy plugin (v0.2.8)", "方案 2：安装旧版插件 (v0.2.8)")}`);
     console.log(`    node install.js --plugin-version=v0.2.8${langZh ? " --zh" : ""}`);
     console.log("");
     process.exit(1);
   }
-}
-
-function checkRequestedOpenVikingCompatibility() {
-  if (!resolvedMinOpenvikingVersion || !openvikingVersion) return;
-  if (versionGte(openvikingVersion, resolvedMinOpenvikingVersion)) return;
-
-  err(tr(
-    `OpenViking ${openvikingVersion} does not support this plugin (requires >= ${resolvedMinOpenvikingVersion})`,
-    `OpenViking ${openvikingVersion} 不支持此插件（需要 >= ${resolvedMinOpenvikingVersion}）`,
-  ));
-  console.log("");
-  console.log(tr(
-    "Use a newer OpenViking version, or omit --openviking-version to install the latest release.",
-    "请使用更新版本的 OpenViking，或省略 --openviking-version 以安装最新版本。",
-  ));
-  process.exit(1);
-}
-
-async function installOpenViking() {
+}
+
+function checkRequestedOpenVikingCompatibility() {
+  if (!resolvedMinOpenvikingVersion || !openvikingVersion) return;
+  if (versionGte(openvikingVersion, resolvedMinOpenvikingVersion)) return;
+
+  err(tr(
+    `OpenViking ${openvikingVersion} does not support this plugin (requires >= ${resolvedMinOpenvikingVersion})`,
+    `OpenViking ${openvikingVersion} 不支持此插件（需要 >= ${resolvedMinOpenvikingVersion}）`,
+  ));
+  console.log("");
+  console.log(tr(
+    "Use a newer OpenViking version, or omit --openviking-version to install the latest release.",
+    "请使用更新版本的 OpenViking，或省略 --openviking-version 以安装最新版本。",
+  ));
+  process.exit(1);
+}
+
+async function installOpenViking() {
   if (process.env.SKIP_OPENVIKING === "1") {
     info(tr("Skipping OpenViking install (SKIP_OPENVIKING=1)", "跳过 OpenViking 安装 (SKIP_OPENVIKING=1)"));
     return;
@@ -646,6 +689,12 @@ async function installOpenViking() {
     err(tr("Python check failed.", "Python 校验失败"));
     process.exit(1);
   }
+  if (!python.ok) {
+    warn(tr(
+      `${python.detail}. Will attempt to find a suitable Python for pip install.`,
+      `${python.detail}。将尝试查找合适的 Python 进行 pip 安装。`,
+    ));
+  }
 
   const py = python.cmd;
 
@@ -809,20 +858,20 @@ async function configureOvConf() {
       rotation_days: 3,
       rotation_interval: "midnight",
     },
-    embedding: {
-      dense: {
-        provider: "volcengine",
-        api_key: embeddingApiKey || null,
-        model: embeddingModel,
-        api_base: "https://ark.cn-beijing.volces.com/api/v3",
+    embedding: {
+      dense: {
+        provider: "volcengine",
+        api_key: embeddingApiKey || null,
+        model: embeddingModel,
+        api_base: "https://ark.cn-beijing.volces.com/api/v3",
         dimension: 1024,
         input: "multimodal",
       },
-    },
-    vlm: {
-      provider: "volcengine",
-      api_key: vlmApiKey || null,
-      model: vlmModel,
+    },
+    vlm: {
+      provider: "volcengine",
+      api_key: vlmApiKey || null,
+      model: vlmModel,
       api_base: "https://ark.cn-beijing.volces.com/api/v3",
       temperature: 0.1,
       max_retries: 3,
@@ -903,29 +952,29 @@ async function downloadPlugin() {
 
   // npm install
   info(tr("Installing plugin npm dependencies...", "正在安装插件 npm 依赖..."));
-  const npmArgs = resolvedNpmOmitDev
-    ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
-    : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
-  await run("npm", npmArgs, { cwd: PLUGIN_DEST, silent: false });
+  const npmArgs = resolvedNpmOmitDev
+    ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
+    : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
+  await run("npm", npmArgs, { cwd: PLUGIN_DEST, silent: false });
   info(tr(`Plugin deployed: ${PLUGIN_DEST}`, `插件部署完成: ${PLUGIN_DEST}`));
 }
 
-async function deployLocalPlugin(localPluginDir) {
-  await rm(PLUGIN_DEST, { recursive: true, force: true });
-  await mkdir(PLUGIN_DEST, { recursive: true });
-  await cp(localPluginDir, PLUGIN_DEST, {
-    recursive: true,
-    force: true,
-    filter: (sourcePath) => {
-      const rel = relative(localPluginDir, sourcePath);
-      if (!rel) return true;
-      const firstSegment = rel.split(/[\\/]/)[0];
-      return firstSegment !== "node_modules" && firstSegment !== ".git";
-    },
-  });
-}
-
-async function configureOpenClawPlugin() {
+async function deployLocalPlugin(localPluginDir) {
+  await rm(PLUGIN_DEST, { recursive: true, force: true });
+  await mkdir(PLUGIN_DEST, { recursive: true });
+  await cp(localPluginDir, PLUGIN_DEST, {
+    recursive: true,
+    force: true,
+    filter: (sourcePath) => {
+      const rel = relative(localPluginDir, sourcePath);
+      if (!rel) return true;
+      const firstSegment = rel.split(/[\\/]/)[0];
+      return firstSegment !== "node_modules" && firstSegment !== ".git";
+    },
+  });
+}
+
+async function configureOpenClawPlugin() {
   info(tr("Configuring OpenClaw plugin...", "正在配置 OpenClaw 插件..."));
 
   const pluginId = resolvedPluginId;
@@ -936,18 +985,18 @@ async function configureOpenClawPlugin() {
     ocEnv.OPENCLAW_STATE_DIR = OPENCLAW_DIR;
   }
 
-  const oc = async (args) => {
-    const result = await runCapture("openclaw", args, { env: ocEnv, shell: IS_WIN });
-    if (result.code !== 0) {
-      const detail = result.err || result.out;
-      throw new Error(`openclaw ${args.join(" ")} failed (exit code ${result.code})${detail ? `: ${detail}` : ""}`);
-    }
-    return result;
-  };
-
-  // Enable plugin (files already deployed to extensions dir by deployPlugin)
-  await oc(["plugins", "enable", pluginId]);
-  await oc(["config", "set", `plugins.slots.${pluginSlot}`, pluginId]);
+  const oc = async (args) => {
+    const result = await runCapture("openclaw", args, { env: ocEnv, shell: IS_WIN });
+    if (result.code !== 0) {
+      const detail = result.err || result.out;
+      throw new Error(`openclaw ${args.join(" ")} failed (exit code ${result.code})${detail ? `: ${detail}` : ""}`);
+    }
+    return result;
+  };
+
+  // Enable plugin (files already deployed to extensions dir by deployPlugin)
+  await oc(["plugins", "enable", pluginId]);
+  await oc(["config", "set", `plugins.slots.${pluginSlot}`, pluginId]);
 
   // Set gateway mode
   await oc(["config", "set", "gateway.mode", "local"]);
@@ -969,22 +1018,34 @@ async function configureOpenClawPlugin() {
     }
   }
 
+  // Legacy (memory) plugins need explicit targetUri/autoRecall/autoCapture (new version has defaults in config.ts)
+  if (resolvedPluginKind === "memory") {
+    await oc(["config", "set", `plugins.entries.${pluginId}.config.targetUri`, "viking://user/memories"]);
+    await oc(["config", "set", `plugins.entries.${pluginId}.config.autoRecall`, "true", "--json"]);
+    await oc(["config", "set", `plugins.entries.${pluginId}.config.autoCapture`, "true", "--json"]);
+  }
+
   info(tr("OpenClaw plugin configured", "OpenClaw 插件配置完成"));
 }
 
+async function discoverOpenvikingPython(failedPy) {
+  const candidates = IS_WIN
+    ? ["python3", "python", "py -3"]
+    : ["python3.13", "python3.12", "python3.11", "python3.10", "python3", "python"];
+  for (const candidate of candidates) {
+    if (candidate === failedPy) continue;
+    const resolved = await resolveAbsoluteCommand(candidate);
+    if (!resolved || resolved === candidate || resolved === failedPy) continue;
+    const check = await runCapture(resolved, ["-c", "import openviking"], { shell: false });
+    if (check.code === 0) return resolved;
+  }
+  return "";
+}
+
 async function resolvePythonPath() {
   if (openvikingPythonPath) return openvikingPythonPath;
   const python = await checkPython();
-  const py = python.cmd;
-  if (!py) return "";
-
-  if (IS_WIN) {
-    const result = await runCapture("where", [py], { shell: true });
-    return result.out.split(/\r?\n/)[0]?.trim() || py;
-  }
-
-  const result = await runCapture("which", [py], { shell: false });
-  return result.out.trim() || py;
+  return python.cmd || "";
 }
 
 async function writeOpenvikingEnv({ includePython }) {
@@ -1001,6 +1062,37 @@ async function writeOpenvikingEnv({ includePython }) {
         ),
       );
     }
+
+    // Verify the resolved Python can actually import openviking
+    if (pythonPath) {
+      const verify = await runCapture(pythonPath, ["-c", "import openviking"], { shell: false });
+      if (verify.code !== 0) {
+        warn(
+          tr(
+            `Resolved Python (${pythonPath}) cannot import openviking. The pip install target may differ from the runtime python3.`,
+            `解析到的 Python（${pythonPath}）无法 import openviking。pip 安装目标可能与运行时的 python3 不一致。`,
+          ),
+        );
+        // Try to discover the correct Python via pip show
+        const corrected = await discoverOpenvikingPython(pythonPath);
+        if (corrected) {
+          info(
+            tr(
+              `Auto-corrected OPENVIKING_PYTHON to ${corrected}`,
+              `已自动修正 OPENVIKING_PYTHON 为 ${corrected}`,
+            ),
+          );
+          pythonPath = corrected;
+        } else {
+          warn(
+            tr(
+              `Could not auto-detect the correct Python. Edit OPENVIKING_PYTHON in the env file manually.`,
+              `无法自动检测正确的 Python。请手动修改 env 文件中的 OPENVIKING_PYTHON。`,
+            ),
+          );
+        }
+      }
+    }
   }
 
   // Remote mode + default state dir + no python line → nothing to persist
@@ -1069,11 +1161,11 @@ async function main() {
   if (selectedMode === "local") {
     await validateEnvironment();
     await checkOpenClaw();
-    // Resolve plugin config after OpenClaw is available (for version detection)
-    await resolvePluginConfig();
-    await checkOpenClawCompatibility();
-    checkRequestedOpenVikingCompatibility();
-    await installOpenViking();
+    // Resolve plugin config after OpenClaw is available (for version detection)
+    await resolvePluginConfig();
+    await checkOpenClawCompatibility();
+    checkRequestedOpenVikingCompatibility();
+    await installOpenViking();
     await configureOvConf();
   } else {
     await checkOpenClaw();
@@ -1088,19 +1180,19 @@ async function main() {
     pluginPath = localPluginDir;
     PLUGIN_DEST = join(OPENCLAW_DIR, "extensions", resolvedPluginId || "openviking");
     info(tr(`Using local plugin from repo: ${pluginPath}`, `使用仓库内插件: ${pluginPath}`));
-    await deployLocalPlugin(pluginPath);
+    await deployLocalPlugin(pluginPath);
       info(tr("Installing plugin npm dependencies...", "正在安装插件 npm 依赖..."));
-    const npmArgs = resolvedNpmOmitDev
-      ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
-      : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
-    await run("npm", npmArgs, { cwd: PLUGIN_DEST, silent: false });
-    pluginPath = PLUGIN_DEST;
+    const npmArgs = resolvedNpmOmitDev
+      ? ["install", "--omit=dev", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY]
+      : ["install", "--no-audit", "--no-fund", "--registry", NPM_REGISTRY];
+    await run("npm", npmArgs, { cwd: PLUGIN_DEST, silent: false });
+    pluginPath = PLUGIN_DEST;
   } else {
     await downloadPlugin();
     pluginPath = PLUGIN_DEST;
   }
 
-  await configureOpenClawPlugin();
+  await configureOpenClawPlugin();
   const envFiles = await writeOpenvikingEnv({
     includePython: selectedMode === "local",
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-openviking-setup-helper",
-  "version": "0.2.9-dev.0",
+  "version": "0.2.9-dev.1",
   "description": "Setup helper for installing OpenViking memory plugin into OpenClaw",
   "type": "module",
   "bin": {