@memtensor/memos-local-openclaw-plugin 0.3.10 → 0.3.11

package/README.md

@@ -77,16 +77,11 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ```
 
-The plugin is installed under `~/.openclaw/extensions/memos-local-openclaw-plugin` and registered as `memos-local-openclaw-plugin`.
+The plugin is installed under `~/.openclaw/extensions/memos-local-openclaw-plugin` and registered as `memos-local-openclaw-plugin`. Dependencies and native modules are built automatically during installation.
 
-> **If the gateway reports `Could not locate the bindings file` for better-sqlite3**, run:
-> ```bash
-> cd ~/.openclaw/extensions/memos-local-openclaw-plugin
-> npm rebuild better-sqlite3
-> ```
-> This compiles the native SQLite module for your system. Requires C++ build tools — macOS: `xcode-select --install`, Linux: `sudo apt install build-essential`.
-
-> **Important:** The Memory Viewer starts only when the **OpenClaw gateway** is running. After install, **configure** `openclaw.json` (step 2) and **start the gateway** (step 3); the viewer will then be available at `http://127.0.0.1:18799`.
+> **Note:** The Memory Viewer starts only when the **OpenClaw gateway** is running. After install, **configure** `openclaw.json` (step 2) and **start the gateway** (step 3); the viewer will then be available at `http://127.0.0.1:18799`.
+>
+> If better-sqlite3 fails to build automatically, ensure you have C++ build tools installed: macOS: `xcode-select --install`, Linux: `sudo apt install build-essential`.
 
 **From source (development):**
 
@@ -467,36 +462,27 @@ TELEMETRY_ENABLED=false
 - Events are batched and sent in the background; failures are silently ignored
 - The anonymous ID is never linked to any personal information
 
-## Reinstall / Upgrade
-
-If you see **"plugin already exists"** or **"plugin not found"**:
+## Upgrade
 
-**Option A — Clean reinstall via OpenClaw CLI:**
 ```bash
-rm -rf ~/.openclaw/extensions/memos-local-openclaw-plugin
-openclaw plugins install @memtensor/memos-local-openclaw-plugin
-cd ~/.openclaw/extensions/memos-local-openclaw-plugin && npm install --omit=dev
-openclaw gateway stop && openclaw gateway start
+openclaw plugins update memos-local-openclaw-plugin
 ```
 
-**Option B — Manual install (when config already references memos-local-openclaw-plugin):**
+The plugin will automatically install dependencies, clean up legacy versions, and rebuild the native SQLite module. After update, restart the gateway:
+
 ```bash
-rm -rf ~/.openclaw/extensions/memos-local
-cd /tmp
-npm pack @memtensor/memos-local-openclaw-plugin
-tar -xzf memtensor-memos-local-openclaw-plugin-*.tgz
-mv package ~/.openclaw/extensions/memos-local-openclaw-plugin
-cd ~/.openclaw/extensions/memos-local-openclaw-plugin && npm install --omit=dev
 openclaw gateway stop && openclaw gateway start
 ```
 
-**Plugin shows as "error" in `openclaw plugins list`?** (e.g. `Cannot find module '@sinclair/typebox'`)
+> **Tip:** To update all plugins at once: `openclaw plugins update --all`
+
+**If `openclaw plugins update` doesn't work** (plugin not in install registry):
 
 ```bash
-cd ~/.openclaw/extensions/memos-local-openclaw-plugin && npm install --omit=dev
+openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ```
 
-Then restart the gateway.
+This will reinstall the latest version. The postinstall script handles everything automatically — no need to manually delete directories or run `npm install`.
 
 ## Troubleshooting
 

package/openclaw.plugin.json

@@ -21,7 +21,7 @@
     "openclaw": ">=2026.2.0"
   },
   "setup": {
-    "postInstall": "npm install --omit=dev && npm rebuild better-sqlite3",
+    "postInstall": "node scripts/postinstall.cjs",
     "notes": [
       "After install, add to ~/.openclaw/openclaw.json: plugins.slots.memory = \"memos-local-openclaw-plugin\"",
       "Set agents.defaults.memorySearch.enabled = false to disable OpenClaw's built-in memory",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memtensor/memos-local-openclaw-plugin",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "MemOS Local memory plugin for OpenClaw — full-write, hybrid-recall, progressive retrieval",
   "type": "module",
   "main": "index.ts",

package/scripts/postinstall.cjs

@@ -18,6 +18,64 @@ function warn(msg) { console.log(`${YELLOW}[memos-local]${RESET} ${msg}`); }
 function ok(msg) { console.log(`${GREEN}[memos-local]${RESET} ${msg}`); }
 function fail(msg) { console.log(`${RED}[memos-local]${RESET} ${msg}`); }
 
+const pluginDir = path.resolve(__dirname, "..");
+
+console.log(`
+${CYAN}${BOLD}┌──────────────────────────────────────────────────┐
+│  MemOS Local Memory — postinstall               │
+└──────────────────────────────────────────────────┘${RESET}
+`);
+
+log(`Plugin dir: ${DIM}${pluginDir}${RESET}`);
+log(`Node: ${process.version}  Platform: ${process.platform}-${process.arch}`);
+
+/* ═══════════════════════════════════════════════════════════
+ *  Phase 0: Ensure all dependencies are installed
+ * ═══════════════════════════════════════════════════════════ */
+
+function ensureDependencies() {
+  const coreDeps = ["@sinclair/typebox", "uuid", "posthog-node", "@huggingface/transformers"];
+  const missing = [];
+  for (const dep of coreDeps) {
+    try {
+      require.resolve(dep, { paths: [pluginDir] });
+    } catch {
+      missing.push(dep);
+    }
+  }
+
+  if (missing.length === 0) {
+    ok("All dependencies present.");
+    return;
+  }
+
+  warn(`Missing dependencies: ${missing.join(", ")}`);
+  log("Running: npm install --omit=dev (this may take a moment)...");
+
+  const startMs = Date.now();
+  const result = spawnSync("npm", ["install", "--omit=dev"], {
+    cwd: pluginDir,
+    stdio: "inherit",
+    shell: true,
+    timeout: 120_000,
+  });
+  const elapsed = ((Date.now() - startMs) / 1000).toFixed(1);
+
+  if (result.status === 0) {
+    ok(`Dependencies installed (${elapsed}s).`);
+  } else {
+    fail(`npm install exited with code ${result.status} (${elapsed}s).`);
+    warn("Some features may not work. Try running manually:");
+    warn(`  cd ${pluginDir} && npm install --omit=dev`);
+  }
+}
+
+try {
+  ensureDependencies();
+} catch (e) {
+  warn(`Dependency check skipped: ${e.message}`);
+}
+
 /* ═══════════════════════════════════════════════════════════
  *  Phase 1: Clean up legacy plugin versions
  * ═══════════════════════════════════════════════════════════ */
@@ -52,7 +110,6 @@ function cleanupLegacy() {
     }
   }
 
-  // Clean up openclaw.json config — migrate old plugin entries
   const cfgPath = path.join(ocHome, "openclaw.json");
   if (fs.existsSync(cfgPath)) {
     try {
@@ -67,9 +124,8 @@ function cleanupLegacy() {
           if (entries[oldKey]) {
             const oldEntry = entries[oldKey];
             if (!entries["memos-local-openclaw-plugin"]) {
-              // Migrate: copy old config to new key
               entries["memos-local-openclaw-plugin"] = oldEntry;
-              log(`Migrated config: ${DIM}${oldKey}${RESET} → ${GREEN}memos-local-openclaw-plugin${RESET}`);
+              log(`Migrated config: ${DIM}${oldKey}${RESET} -> ${GREEN}memos-local-openclaw-plugin${RESET}`);
             }
             delete entries[oldKey];
             cfgChanged = true;
@@ -77,7 +133,6 @@ function cleanupLegacy() {
           }
         }
 
-        // Fix source path if it points to old directory names
         const newEntry = entries["memos-local-openclaw-plugin"];
         if (newEntry && typeof newEntry.source === "string") {
           const oldSource = newEntry.source;
@@ -86,14 +141,13 @@ function cleanupLegacy() {
               .replace(/memos-lite-openclaw-plugin/g, "memos-local-openclaw-plugin")
               .replace(/memos-lite/g, "memos-local");
             if (newEntry.source !== oldSource) {
-              log(`Updated source path: ${DIM}${oldSource}${RESET} → ${GREEN}${newEntry.source}${RESET}`);
+              log(`Updated source path: ${DIM}${oldSource}${RESET} -> ${GREEN}${newEntry.source}${RESET}`);
               cfgChanged = true;
             }
           }
         }
 
         if (cfgChanged) {
-          // Write back with backup
           const backup = cfgPath + ".bak-" + Date.now();
           fs.copyFileSync(cfgPath, backup);
           fs.writeFileSync(cfgPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
@@ -127,18 +181,18 @@ log("Checking better-sqlite3 native module...");
 try {
   require("better-sqlite3");
   ok("better-sqlite3 is ready.");
+  console.log(`\n${GREEN}${BOLD}[memos-local] Setup complete!${RESET} Restart the gateway: ${CYAN}openclaw gateway stop && openclaw gateway start${RESET}\n`);
   process.exit(0);
 } catch (_) {
   warn("better-sqlite3 native bindings not found, attempting rebuild...");
 }
 
-log(`Node: ${process.version}  Platform: ${process.platform}-${process.arch}`);
 log("Running: npm rebuild better-sqlite3 (this may take 30-60 seconds)...");
 
 const startMs = Date.now();
 
 const result = spawnSync("npm", ["rebuild", "better-sqlite3"], {
-  cwd: path.resolve(__dirname, ".."),
+  cwd: pluginDir,
   stdio: "inherit",
   shell: true,
   timeout: 180_000,
@@ -151,6 +205,7 @@ if (result.status === 0) {
     delete require.cache[require.resolve("better-sqlite3")];
     require("better-sqlite3");
     ok(`better-sqlite3 rebuilt successfully (${elapsed}s).`);
+    console.log(`\n${GREEN}${BOLD}[memos-local] Setup complete!${RESET} Restart the gateway: ${CYAN}openclaw gateway stop && openclaw gateway start${RESET}\n`);
     process.exit(0);
   } catch (_) {
     fail(`Rebuild completed but module still cannot load (${elapsed}s).`);
@@ -159,7 +214,6 @@ if (result.status === 0) {
   fail(`Rebuild failed with exit code ${result.status} (${elapsed}s).`);
 }
 
-const pluginDir = path.resolve(__dirname, "..");
 console.log(`
 ${YELLOW}${BOLD}╔══════════════════════════════════════════════════════════════╗
 ║  better-sqlite3 native module build failed                   ║
@@ -176,6 +230,7 @@ ${YELLOW}║${RESET}
 ${YELLOW}║${RESET}  Then retry:                                                ${YELLOW}║${RESET}
 ${YELLOW}║${RESET}  ${GREEN}cd ${pluginDir}${RESET}
 ${YELLOW}║${RESET}  ${GREEN}npm rebuild better-sqlite3${RESET}                                ${YELLOW}║${RESET}
+${YELLOW}║${RESET}  ${GREEN}openclaw gateway stop && openclaw gateway start${RESET}           ${YELLOW}║${RESET}
 ${YELLOW}${BOLD}╚══════════════════════════════════════════════════════════════╝${RESET}
 `);