@memtensor/memos-local-openclaw-plugin 1.0.6-beta.9 → 1.0.7

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "MemOS Local Memory",
   "description": "Full-write local conversation memory with hybrid search (RRF + MMR + recency), task summarization, skill evolution, and team sharing (Hub-Client). Provides memory_search, memory_get, task_summary, skill_search, task_share, network_skill_pull, network_team_info, memory_viewer for layered retrieval and team collaboration.",
   "kind": "memory",
-  "version": "1.0.6-beta.9",
+  "version": "1.0.6-beta.11",
   "skills": [
     "skill/memos-memory-guide"
   ],

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@memtensor/memos-local-openclaw-plugin",
-  "version": "1.0.6-beta.9",
+  "version": "1.0.7",
   "description": "MemOS Local memory plugin for OpenClaw — full-write, hybrid-recall, progressive retrieval",
   "type": "module",
   "main": "index.ts",
-  "types": "dist/index.d.ts",
   "files": [
     "index.ts",
     "src",
-    "dist",
     "skill",
     "prebuilds",
     "scripts/native-binding.cjs",
@@ -36,7 +34,7 @@
     "test:watch": "vitest",
     "test:accuracy": "tsx scripts/run-accuracy-test.ts",
     "postinstall": "node scripts/postinstall.cjs",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "echo 'Source-only publish — no build needed.'"
   },
   "keywords": [
     "openclaw",
@@ -47,7 +45,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "dependencies": {
     "@huggingface/transformers": "^3.8.0",

package/scripts/postinstall.cjs

@@ -117,7 +117,7 @@ try {
  * ═══════════════════════════════════════════════════════════ */
 
 function ensureDependencies() {
-  phase(0, "检测核心依赖 / Check core dependencies");
+  phase(0, "Check core dependencies / 检测核心依赖");
 
   const coreDeps = ["@sinclair/typebox", "uuid", "@huggingface/transformers"];
   const missing = [];
@@ -170,7 +170,7 @@ try {
  * ═══════════════════════════════════════════════════════════ */
 
 function cleanupLegacy() {
-  phase(1, "清理旧版本插件 / Clean up legacy plugins");
+  phase(1, "Clean up legacy plugins / 清理旧版本插件");
 
   const home = process.env.HOME || process.env.USERPROFILE || "";
   if (!home) { log("Cannot determine HOME directory, skipping."); return; }
@@ -281,7 +281,7 @@ try {
  * ═══════════════════════════════════════════════════════════ */
 
 function installBundledSkill() {
-  phase(2, "安装记忆技能 / Install memory skill");
+  phase(2, "Install memory skill / 安装记忆技能");
 
   const home = process.env.HOME || process.env.USERPROFILE || "";
   if (!home) { warn("Cannot determine HOME directory, skipping skill install."); return; }
@@ -347,7 +347,7 @@ try {
  *  Phase 3: Verify better-sqlite3 native module
  * ═══════════════════════════════════════════════════════════ */
 
-phase(3, "检查 better-sqlite3 原生模块 / Check native module");
+phase(3, "Check native module / 检查 better-sqlite3 原生模块");
 
 const sqliteModulePath = path.join(pluginDir, "node_modules", "better-sqlite3");
 
@@ -502,43 +502,43 @@ async function setupSharingWizard() {
   const existingSharing = pluginEntry?.config?.sharing;
 
   if (existingSharing?.enabled) {
-    const roleLabel = existingSharing.role === "hub" ? "Hub (团队中心)" : "Client (团队成员)";
-    log(`已检测到共享配置: 角色 = ${BOLD}${roleLabel}${RESET}`);
+    const roleLabel = existingSharing.role === "hub" ? "Hub (Team Center)" : "Client (Team Member)";
+    log(`Sharing config detected: role = ${BOLD}${roleLabel}${RESET}`);
     const prompt = createPrompt();
-    const ans = await prompt.ask(`  是否重新配置？/ Reconfigure? (y/N) > `);
+    const ans = await prompt.ask(`  Reconfigure? / 是否重新配置？(y/N) > `);
     prompt.close();
     if (ans.toLowerCase() !== "y") {
-      ok("保留现有共享配置。");
+      ok("Keeping existing sharing config. / 保留现有共享配置。");
       return;
     }
   }
 
-  phase(3, "局域网共享设置 / LAN Sharing Setup");
+  phase(3, "LAN Sharing Setup / 局域网共享设置");
 
   const prompt = createPrompt();
 
-  const enableAns = await prompt.ask(`  是否启用局域网记忆共享？/ Enable LAN sharing? (y/N) > `);
+  const enableAns = await prompt.ask(`  Enable LAN sharing? / 是否启用局域网记忆共享？(y/N) > `);
   if (enableAns.toLowerCase() !== "y") {
     prompt.close();
-    log("未启用共享。你可以稍后在 openclaw.json 中手动配置。");
+    log("Sharing not enabled. You can configure it later in openclaw.json. / 未启用共享。");
     return;
   }
 
   console.log(`
-  ${BOLD}请选择你的角色 / Choose your role:${RESET}
-    ${GREEN}1)${RESET} 创建团队 (Hub)   — 成为团队管理员，其他人连接你
-    ${GREEN}2)${RESET} 加入团队 (Client) — 连接到已有的 Hub
+  ${BOLD}Choose your role / 请选择你的角色:${RESET}
+    ${GREEN}1)${RESET} Create Team (Hub)   — become the team admin, others connect to you / 创建团队
+    ${GREEN}2)${RESET} Join Team (Client)  — connect to an existing Hub / 加入团队
 `);
 
-  const roleAns = await prompt.ask(`  请输入 1 或 2 / Enter 1 or 2 > `);
+  const roleAns = await prompt.ask(`  Enter 1 or 2 / 请输入 1 或 2 > `);
 
   let sharingConfig;
 
   if (roleAns === "1") {
-    console.log(`\n  ${CYAN}${BOLD}── Hub 设置 / Hub Setup ──${RESET}\n`);
+    console.log(`\n  ${CYAN}${BOLD}── Hub Setup / Hub 设置 ──${RESET}\n`);
 
-    const teamName = (await prompt.ask(`  团队名称 / Team name (默认: My Team) > `)) || "My Team";
-    const portStr = (await prompt.ask(`  Hub 端口 / Hub port (默认: 18800) > `)) || "18800";
+    const teamName = (await prompt.ask(`  Team name / 团队名称 (default: My Team) > `)) || "My Team";
+    const portStr = (await prompt.ask(`  Hub port / Hub 端口 (default: 18800) > `)) || "18800";
     const port = parseInt(portStr, 10) || 18800;
     const teamToken = generateTeamToken();
 
@@ -553,46 +553,46 @@ async function setupSharingWizard() {
 
     console.log(`
 ${GREEN}${BOLD}  ┌────────────────────────────────────────────────────────────┐
-  │  ✔ Hub 配置完成！/ Hub configured!                        │
+  │  ✔ Hub configured! / Hub 配置完成！                       │
   │                                                            │
-  │  请将以下信息分享给团队成员:                                │
   │  Share this info with your team:                           │
+  │  请将以下信息分享给团队成员:                                │
   │                                                            │
-  │  ${CYAN}Hub 地址 / Address : ${displayIP}:${port}${GREEN}
+  │  ${CYAN}Address / Hub 地址 : ${displayIP}:${port}${GREEN}
   │  ${CYAN}Team Token         : ${teamToken}${GREEN}
   │                                                            │
-  │  团队成员安装插件时选择 "加入团队" 并输入以上信息。          │
+  │  Team members should choose "Join Team" during install.    │
   └────────────────────────────────────────────────────────────┘${RESET}
 `);
 
     if (localIPs.length > 1) {
-      log("检测到多个网络接口 / Multiple network interfaces:");
+      log("Multiple network interfaces detected / 检测到多个网络接口:");
       for (const ip of localIPs) {
         log(`  ${ip.name}: ${BOLD}${ip.address}:${port}${RESET}`);
       }
     }
 
   } else if (roleAns === "2") {
-    console.log(`\n  ${CYAN}${BOLD}── 加入团队 / Join Team ──${RESET}\n`);
+    console.log(`\n  ${CYAN}${BOLD}── Join Team / 加入团队 ──${RESET}\n`);
 
-    const hubAddress = await prompt.ask(`  Hub 地址 / Hub address (如 192.168.1.100:18800) > `);
+    const hubAddress = await prompt.ask(`  Hub address / Hub 地址 (e.g. 192.168.1.100:18800) > `);
     if (!hubAddress) {
       prompt.close();
-      warn("Hub 地址不能为空，跳过配置。");
+      warn("Hub address cannot be empty, skipping. / Hub 地址不能为空。");
       return;
     }
 
-    const teamToken = await prompt.ask(`  Team Token (由 Hub 创建者提供 / from Hub creator) > `);
+    const teamToken = await prompt.ask(`  Team Token (from Hub creator / 由 Hub 创建者提供) > `);
     if (!teamToken) {
       prompt.close();
-      warn("Team Token 不能为空，跳过配置。");
+      warn("Team Token cannot be empty, skipping. / Team Token 不能为空。");
       return;
     }
 
-    const username = (await prompt.ask(`  你的用户名 / Your username (默认: ${os.userInfo().username}) > `)) || os.userInfo().username;
+    const username = (await prompt.ask(`  Your username / 你的用户名 (default: ${os.userInfo().username}) > `)) || os.userInfo().username;
 
     const hubUrl = /^https?:\/\//i.test(hubAddress.trim()) ? hubAddress.trim() : `http://${hubAddress.trim()}`;
-    log(`正在加入团队 / Joining team at: ${BOLD}${hubUrl}${RESET} ...`);
+    log(`Joining team at / 正在加入团队: ${BOLD}${hubUrl}${RESET} ...`);
 
     let userToken = "";
     let joinOk = false;
@@ -626,18 +626,18 @@ ${GREEN}${BOLD}  ┌────────────────────
       if (joinResult.status === 200 && joinResult.body.userToken) {
         userToken = joinResult.body.userToken;
         joinOk = true;
-        ok(`加入成功！/ Joined successfully! 用户: ${BOLD}${username}${RESET}`);
+        ok(`Joined successfully! / 加入成功！User: ${BOLD}${username}${RESET}`);
       } else if (joinResult.status === 403) {
         prompt.close();
-        fail("Team Token 无效 / Invalid Team Token");
+        fail("Invalid Team Token / Team Token 无效");
         return;
       } else {
-        warn(`Hub 返回 / Hub responded: ${joinResult.status} ${JSON.stringify(joinResult.body)}`);
-        log("配置将被保存，gateway 启动时会用 Team Token 自动重试加入。");
+        warn(`Hub responded / Hub 返回: ${joinResult.status} ${JSON.stringify(joinResult.body)}`);
+        log("Config will be saved; gateway will auto-retry joining with Team Token on startup. / 配置将被保存，gateway 启动时会自动重试。");
       }
     } catch (e) {
-      warn(`无法连接 Hub / Cannot reach Hub: ${e.message}`);
-      log("配置将被保存，gateway 启动时会用 Team Token 自动重试加入。");
+      warn(`Cannot reach Hub / 无法连接 Hub: ${e.message}`);
+      log("Config will be saved; gateway will auto-retry joining on startup. / 配置将被保存，gateway 启动时会自动重试。");
     }
 
     sharingConfig = {
@@ -648,11 +648,11 @@ ${GREEN}${BOLD}  ┌────────────────────
     if (userToken) sharingConfig.client.userToken = userToken;
 
     const statusMsg = joinOk
-      ? `已加入团队，重启 gateway 即生效`
-      : `Hub 暂不可达，gateway 启动时会自动加入`;
+      ? `Joined team, restart gateway to take effect`
+      : `Hub unreachable, gateway will auto-join on startup`;
     console.log(`
 ${GREEN}${BOLD}  ┌────────────────────────────────────────────────────────────┐
-  │  ✔ Client 配置完成！/ Client configured!                  │
+  │  ✔ Client configured! / Client 配置完成！                 │
   │  ${CYAN}Hub: ${hubAddress}${GREEN}
   │  ${CYAN}${statusMsg}${GREEN}
   └────────────────────────────────────────────────────────────┘${RESET}
@@ -660,7 +660,7 @@ ${GREEN}${BOLD}  ┌────────────────────
 
   } else {
     prompt.close();
-    warn(`无效选择 "${roleAns}"，跳过配置。你可以稍后在 openclaw.json 中手动配置。`);
+    warn(`Invalid choice "${roleAns}", skipping. You can configure later in openclaw.json. / 无效选择，跳过配置。`);
     return;
   }
 
@@ -679,11 +679,11 @@ ${GREEN}${BOLD}  ┌────────────────────
     const backup = cfgPath + ".bak-" + Date.now();
     fs.copyFileSync(cfgPath, backup);
     fs.writeFileSync(cfgPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
-    ok(`配置已写入 / Config saved: ${DIM}~/.openclaw/openclaw.json${RESET}`);
-    log(`备份 / Backup: ${DIM}${backup}${RESET}`);
+    ok(`Config saved / 配置已写入: ${DIM}~/.openclaw/openclaw.json${RESET}`);
+    log(`Backup / 备份: ${DIM}${backup}${RESET}`);
   } catch (e) {
-    fail(`写入配置失败 / Config write failed: ${e.message}`);
-    warn("请手动编辑 ~/.openclaw/openclaw.json 添加 sharing 配置。");
+    fail(`Config write failed / 写入配置失败: ${e.message}`);
+    warn("Please manually edit ~/.openclaw/openclaw.json to add sharing config. / 请手动编辑配置。");
   }
 }
 

package/skill/memos-memory-guide/SKILL.md

@@ -1,6 +1,26 @@
 ---
 name: memos-memory-guide
 description: "Use the MemOS Local memory system to search and use the user's past conversations. Use this skill whenever the user refers to past chats, their own preferences or history, or when you need to answer from prior context. When auto-recall returns nothing (long or unclear user query), generate your own short search query and call memory_search. Available tools: memory_search, memory_get, memory_write_public, memory_share, memory_unshare, task_summary, skill_get, skill_search, skill_install, skill_publish, skill_unpublish, network_memory_detail, network_skill_pull, network_team_info, memory_timeline, memory_viewer."
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - node
+        - npm
+      anyBins:
+        - curl
+        - wget
+      env:
+        - OPENCLAW_STATE_DIR
+        - OPENCLAW_CONFIG_PATH
+      config:
+        - ~/.openclaw/openclaw.json
+    install:
+      - kind: node
+        package: better-sqlite3
+        bins: []
+    emoji: "\U0001F9E0"
+    homepage: https://github.com/nicekate/MemOS
 ---
 
 # MemOS Local Memory — Agent Guide

package/src/update-check.ts

@@ -52,26 +52,21 @@ export async function computeUpdateCheck(
 
   if (onBeta) {
     channel = "beta";
-    // Beta users: only compare against beta tag; never suggest "updating" to stable via gt confusion.
     if (betaTag && semver.valid(betaTag) && semver.gt(betaTag, current)) {
       updateAvailable = true;
       targetVersion = betaTag;
-      installCommand = `openclaw plugins install ${packageName}@beta`;
     } else {
       targetVersion = betaTag && semver.valid(betaTag) ? betaTag : current;
-      if (betaTag && semver.valid(betaTag) && semver.eq(betaTag, current)) {
-        installCommand = `openclaw plugins install ${packageName}@beta`;
-      }
     }
+    installCommand = `openclaw plugins install ${packageName}@${targetVersion}`;
   } else {
-    // Stable users: compare against latest only.
     if (latestTag && semver.valid(latestTag) && semver.gt(latestTag, current)) {
       updateAvailable = true;
       targetVersion = latestTag;
-      installCommand = `openclaw plugins install ${packageName}`;
     } else {
       targetVersion = latestTag && semver.valid(latestTag) ? latestTag : current;
     }
+    installCommand = `openclaw plugins install ${packageName}@${targetVersion}`;
   }
 
   // Beta user + stable exists on latest: optional hint to switch to stable (not counted as "update").

package/src/viewer/html.ts

@@ -9051,11 +9051,11 @@ function waitForGatewayAndReload(maxAttempts,attempt){
     });
   },delay);
 }
-function doUpdateInstall(packageSpec,btnEl,statusEl){
+function doUpdateInstall(packageSpec,btnEl,statusEl,targetVersion){
   btnEl.disabled=true;
   btnEl.textContent=t('update.installing');
   btnEl.style.cssText='background:rgba(99,102,241,.15);color:var(--pri);border:1px solid rgba(99,102,241,.3);border-radius:6px;padding:4px 14px;font-size:12px;font-weight:600;cursor:wait;white-space:nowrap';
-  fetch('/api/update-install',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({packageSpec:packageSpec})})
+  fetch('/api/update-install',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({packageSpec:packageSpec,targetVersion:targetVersion||''})})
     .then(function(r){return r.json()})
     .then(function(d){
       if(d.ok){
@@ -9082,7 +9082,7 @@ async function checkForUpdate(){
     if(!r.ok)return;
     const d=await r.json();
     if(!d.updateAvailable)return;
-    const pkgSpec=d.installCommand?d.installCommand.replace(/^(?:npx\s+)?openclaw\s+plugins\s+install\s+/,''):(d.packageName+'@'+d.latest);
+    const pkgSpec=d.packageName+'@'+d.latest;
     var bannerWrap=document.createElement('div');
     bannerWrap.id='updateBannerWrap';
     bannerWrap.style.cssText='background:linear-gradient(135deg,rgba(99,102,241,.08),rgba(139,92,246,.06));border-bottom:1px solid rgba(99,102,241,.18);backdrop-filter:blur(8px);animation:slideIn .3s ease';
@@ -9099,7 +9099,7 @@ async function checkForUpdate(){
     btnUpdate.onmouseleave=function(){this.style.opacity='1';this.style.transform='scale(1)'};
     var statusDiv=document.createElement('div');
     statusDiv.style.cssText='font-size:11px;opacity:.7;flex-shrink:0';
-    btnUpdate.onclick=function(){doUpdateInstall(pkgSpec,btnUpdate,statusDiv)};
+    btnUpdate.onclick=function(){doUpdateInstall(pkgSpec,btnUpdate,statusDiv,d.latest)};
     textNode.appendChild(btnUpdate);
     var spacer=document.createElement('div');
     spacer.style.cssText='flex:1';

package/src/viewer/server.ts

@@ -3332,13 +3332,14 @@ export class ViewerServer {
     req.on("data", (chunk: Buffer) => { body += chunk.toString(); });
     req.on("end", () => {
       try {
-        const { packageSpec: rawSpec } = JSON.parse(body);
+        const { packageSpec: rawSpec, targetVersion: rawTargetVersion } = JSON.parse(body);
         if (!rawSpec || typeof rawSpec !== "string") {
           res.writeHead(400, { "Content-Type": "application/json" });
           res.end(JSON.stringify({ ok: false, error: "Missing packageSpec" }));
           return;
         }
         const packageSpec = rawSpec.trim().replace(/^(?:npx\s+)?openclaw\s+plugins\s+install\s+/i, "");
+        const targetVersion = typeof rawTargetVersion === "string" ? rawTargetVersion.trim() : "";
         const allowed = /^@[\w-]+\/[\w.-]+(@[\w.-]+)?$/;
         this.log.info(`update-install: received packageSpec="${packageSpec}" (len=${packageSpec.length})`);
         if (!allowed.test(packageSpec)) {
@@ -3465,13 +3466,22 @@ export class ViewerServer {
                     return;
                   }
 
-                  // Read new version
                   let newVersion = "unknown";
                   try {
                     const newPkg = JSON.parse(fs.readFileSync(path.join(extDir, "package.json"), "utf-8"));
                     newVersion = newPkg.version ?? newVersion;
                   } catch {}
 
+                  if (targetVersion && newVersion !== targetVersion) {
+                    this.log.warn(`update-install: version mismatch! expected=${targetVersion}, got=${newVersion} — rolling back`);
+                    rollbackInstall();
+                    this.jsonResponse(res, {
+                      ok: false,
+                      error: `Version mismatch: expected ${targetVersion} but downloaded ${newVersion}. npm cache may be stale — please try again.`,
+                    });
+                    return;
+                  }
+
                   discardBackup();
                   this.log.info(`update-install: success! Updated to ${newVersion}`);
                   this.jsonResponseAndRestart(res, { ok: true, version: newVersion }, "update-install");

package/telemetry.credentials.json

@@ -0,0 +1,5 @@
+{
+  "endpoint": "https://proj-xtrace-e218d9316b328f196a3c640cc7ca84-cn-hangzhou.cn-hangzhou.log.aliyuncs.com/rum/web/v2?workspace=default-cms-1026429231103299-cn-hangzhou&service_id=a3u72ukxmr@066657d42a13a9a9f337f",
+  "pid": "a3u72ukxmr@066657d42a13a9a9f337f",
+  "env": "prod"
+}

package/dist/capture/index.d.ts

@@ -1,26 +0,0 @@
-import type { ConversationMessage, Logger } from "../types";
-/**
- * Extract writable messages from a conversation turn.
- *
- * Stores the user's actual text — strips only OpenClaw's injected metadata
- * prefixes (Sender info, conversation context, etc.) which are not user content.
- * Only skips: system prompts and our own memory tool results (prevents loop).
- */
-export declare function captureMessages(messages: Array<{
-    role: string;
-    content: string;
-    toolName?: string;
-}>, sessionKey: string, turnId: string, evidenceTag: string, log: Logger, owner?: string, userSearchTime?: number): ConversationMessage[];
-/**
- * Strip OpenClaw-injected inbound metadata blocks from user messages.
- *
- * These blocks have the shape:
- *   Sender (untrusted metadata):
- *   ```json
- *   { "label": "...", "id": "..." }
- *   ```
- *
- * Also strips the envelope timestamp prefix like "[Tue 2026-03-03 21:58 GMT+8] "
- */
-export declare function stripInboundMetadata(text: string): string;
-//# sourceMappingURL=index.d.ts.map

package/dist/capture/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAQ,MAAM,EAAE,MAAM,UAAU,CAAC;AAiDlE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,mBAAmB,EAAE,CA6DvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+CzD"}