@memtensor/memos-local-openclaw-plugin 0.3.15 → 0.3.17

package/README.md

@@ -476,16 +476,19 @@ openclaw gateway stop && openclaw gateway start
 
 > **Tip:** To update all plugins at once: `openclaw plugins update --all`
 
-**If `openclaw plugins update` doesn't work** (plugin not in install registry):
+**If `openclaw plugins update` doesn't work** (plugin not in install registry), reinstall:
 
 ```bash
+rm -rf ~/.openclaw/extensions/memos-local-openclaw-plugin
 openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ```
 
-This will reinstall the latest version. The postinstall script handles everything automatically — no need to manually delete directories or run `npm install`.
+> **Note:** `openclaw plugins install` requires the target directory to not exist. If you see `plugin already exists`, delete the directory first. Your memory data is stored separately at `~/.openclaw/memos-local/memos.db` and will not be affected.
 
 ## Troubleshooting
 
+> 📖 **详细排查指南 / Detailed troubleshooting guide:** [docs/troubleshooting.html](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/docs/troubleshooting.html) — 包含逐步排查流程、日志查看方法、完全重装步骤等。
+
 ### Common Issues
 
 1. **Note the exact error** — e.g. `plugin not found`, `Cannot find module 'xxx'`, `Invalid config`.

package/index.ts

@@ -14,7 +14,7 @@ import { SqliteStore } from "./src/storage/sqlite";
 import { Embedder } from "./src/embedding";
 import { IngestWorker } from "./src/ingest/worker";
 import { RecallEngine } from "./src/recall/engine";
-import { captureMessages } from "./src/capture";
+import { captureMessages, stripInboundMetadata } from "./src/capture";
 import { DEFAULTS } from "./src/types";
 import { ViewerServer } from "./src/viewer/server";
 import { SkillEvolver } from "./src/skill/evolver";
@@ -76,17 +76,27 @@ const memosLocalPlugin = {
 
   register(api: OpenClawPluginApi) {
     // ─── Ensure better-sqlite3 native module is available ───
+    const pluginDir = path.dirname(new URL(import.meta.url).pathname);
     let sqliteReady = false;
-    try {
-      require("better-sqlite3");
-      sqliteReady = true;
-    } catch (_e) {
-      // Not ready — attempt auto-rebuild
+
+    function trySqliteLoad(): boolean {
+      try {
+        const resolved = require.resolve("better-sqlite3", { paths: [pluginDir] });
+        if (!resolved.startsWith(pluginDir)) {
+          api.logger.warn(`memos-local: better-sqlite3 resolved outside plugin dir: ${resolved}`);
+          return false;
+        }
+        require(resolved);
+        return true;
+      } catch {
+        return false;
+      }
     }
 
+    sqliteReady = trySqliteLoad();
+
     if (!sqliteReady) {
-      const pluginDir = path.dirname(new URL(import.meta.url).pathname);
-      api.logger.warn(`memos-local: better-sqlite3 not found, attempting auto-rebuild in ${pluginDir} ...`);
+      api.logger.warn(`memos-local: better-sqlite3 not found in ${pluginDir}, attempting auto-rebuild ...`);
 
       try {
         const { spawnSync } = require("child_process");
@@ -103,16 +113,14 @@ const memosLocalPlugin = {
         if (stderr) api.logger.warn(`memos-local: rebuild stderr: ${stderr.slice(0, 500)}`);
 
         if (rebuildResult.status === 0) {
-          // Clear require cache and retry
-          try {
-            delete require.cache[require.resolve("better-sqlite3")];
-          } catch { /* ignore */ }
-          try {
-            require("better-sqlite3");
-            sqliteReady = true;
+          Object.keys(require.cache)
+            .filter(k => k.includes("better-sqlite3") || k.includes("better_sqlite3"))
+            .forEach(k => delete require.cache[k]);
+          sqliteReady = trySqliteLoad();
+          if (sqliteReady) {
             api.logger.info("memos-local: better-sqlite3 auto-rebuild succeeded!");
-          } catch (retryErr) {
-            api.logger.warn(`memos-local: rebuild exited 0 but module still fails: ${retryErr}`);
+          } else {
+            api.logger.warn("memos-local: rebuild exited 0 but module still not loadable from plugin dir");
           }
         } else {
           api.logger.warn(`memos-local: rebuild exited with code ${rebuildResult.status}`);
@@ -710,7 +718,7 @@ const memosLocalPlugin = {
           const tail = rawPrompt.slice(lastDoubleNewline + 2).trim();
           if (tail.length >= 2) query = tail;
         }
-        query = query.replace(/^\[.*?\]\s*/, "");
+        query = stripInboundMetadata(query);
         query = query.replace(/<[^>]+>/g, "").trim();
         recallQuery = query;
 

package/package.json

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

package/scripts/postinstall.cjs

@@ -190,8 +190,27 @@ try {
 
 phase(2, "检查 better-sqlite3 原生模块 / Check native module");
 
-try {
-  require("better-sqlite3");
+const sqliteModulePath = path.join(pluginDir, "node_modules", "better-sqlite3");
+const sqliteBuildDir = path.join(sqliteModulePath, "build", "Release");
+const sqliteBindingFile = path.join(sqliteBuildDir, "better_sqlite3.node");
+
+function sqliteBindingsExist() {
+  if (fs.existsSync(sqliteBindingFile)) return true;
+  try {
+    const resolved = require.resolve("better-sqlite3", { paths: [pluginDir] });
+    log(`Resolved better-sqlite3 at: ${DIM}${resolved}${RESET}`);
+    if (!resolved.startsWith(pluginDir)) {
+      warn("Resolved outside plugin dir — treating as missing.");
+      return false;
+    }
+    require(resolved);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+if (sqliteBindingsExist()) {
   ok("better-sqlite3 is ready.");
   console.log(`
 ${GREEN}${BOLD}  ┌──────────────────────────────────────────────────┐
@@ -202,8 +221,9 @@ ${GREEN}${BOLD}  ┌────────────────────
   └──────────────────────────────────────────────────┘${RESET}
 `);
   process.exit(0);
-} catch (_) {
-  warn("better-sqlite3 native bindings not found.");
+} else {
+  warn("better-sqlite3 native bindings not found in plugin dir.");
+  log(`Expected: ${DIM}${sqliteBindingFile}${RESET}`);
   log("Running: npm rebuild better-sqlite3 (may take 30-60s)...");
 }
 
@@ -224,9 +244,7 @@ if (stdout) log(`rebuild output: ${DIM}${stdout.slice(0, 500)}${RESET}`);
 if (stderr) warn(`rebuild stderr: ${DIM}${stderr.slice(0, 500)}${RESET}`);
 
 if (result.status === 0) {
-  try {
-    delete require.cache[require.resolve("better-sqlite3")];
-    require("better-sqlite3");
+  if (sqliteBindingsExist()) {
     ok(`better-sqlite3 rebuilt successfully (${elapsed}s).`);
     console.log(`
 ${GREEN}${BOLD}  ┌──────────────────────────────────────────────────┐
@@ -237,8 +255,9 @@ ${GREEN}${BOLD}  ┌────────────────────
   └──────────────────────────────────────────────────┘${RESET}
 `);
     process.exit(0);
-  } catch (retryErr) {
-    fail(`Rebuild completed but module still fails (${elapsed}s): ${retryErr.message}`);
+  } else {
+    fail(`Rebuild completed but bindings still missing (${elapsed}s).`);
+    fail(`Looked in: ${sqliteBuildDir}`);
   }
 } else {
   fail(`Rebuild failed with exit code ${result.status} (${elapsed}s).`);