@memtensor/memos-cloud-openclaw-plugin 0.1.10-beta.4 → 0.1.10

package/README.md

@@ -101,8 +101,8 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `MEMOS_RECALL_FILTER_BASE_URL` (OpenAI-compatible base URL, e.g. `http://127.0.0.1:11434/v1`)
 - `MEMOS_RECALL_FILTER_API_KEY` (optional; required if your endpoint needs auth)
 - `MEMOS_RECALL_FILTER_MODEL` (model name used to filter recall candidates)
-- `MEMOS_RECALL_FILTER_TIMEOUT_MS` (default: `6000`)
-- `MEMOS_RECALL_FILTER_RETRIES` (default: `0`)
+- `MEMOS_RECALL_FILTER_TIMEOUT_MS` (default: `30000`)
+- `MEMOS_RECALL_FILTER_RETRIES` (default: `1`)
 - `MEMOS_RECALL_FILTER_CANDIDATE_LIMIT` (default: `30` per category)
 - `MEMOS_RECALL_FILTER_MAX_ITEM_CHARS` (default: `500`)
 - `MEMOS_RECALL_FILTER_FAIL_OPEN` (default: `true`; fallback to unfiltered recall on failure)
@@ -146,8 +146,8 @@ In `plugins.entries.memos-cloud-openclaw-plugin.config`:
   "recallFilterBaseUrl": "http://127.0.0.1:11434/v1",
   "recallFilterApiKey": "",
   "recallFilterModel": "qwen2.5:7b",
-  "recallFilterTimeoutMs": 6000,
-  "recallFilterRetries": 0,
+  "recallFilterTimeoutMs": 30000,
+  "recallFilterRetries": 1,
   "recallFilterCandidateLimit": 30,
   "recallFilterMaxItemChars": 500,
   "recallFilterFailOpen": true,

package/README_ZH.md

@@ -103,8 +103,8 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `MEMOS_RECALL_FILTER_BASE_URL`（OpenAI 兼容接口，例如 `http://127.0.0.1:11434/v1`）
 - `MEMOS_RECALL_FILTER_API_KEY`（可选，若你的接口需要鉴权）
 - `MEMOS_RECALL_FILTER_MODEL`（用于筛选记忆的模型名）
-- `MEMOS_RECALL_FILTER_TIMEOUT_MS`（默认 `6000`）
-- `MEMOS_RECALL_FILTER_RETRIES`（默认 `0`）
+- `MEMOS_RECALL_FILTER_TIMEOUT_MS`（默认 `30000`）
+- `MEMOS_RECALL_FILTER_RETRIES`（默认 `1`）
 - `MEMOS_RECALL_FILTER_CANDIDATE_LIMIT`（默认每类 `30` 条）
 - `MEMOS_RECALL_FILTER_MAX_ITEM_CHARS`（默认 `500`）
 - `MEMOS_RECALL_FILTER_FAIL_OPEN`（默认 `true`；筛选失败时回退为“不过滤”）
@@ -146,8 +146,8 @@ MEMOS_API_KEY=YOUR_TOKEN
   "recallFilterBaseUrl": "http://127.0.0.1:11434/v1",
   "recallFilterApiKey": "",
   "recallFilterModel": "qwen2.5:7b",
-  "recallFilterTimeoutMs": 6000,
-  "recallFilterRetries": 0,
+  "recallFilterTimeoutMs": 30000,
+  "recallFilterRetries": 1,
   "recallFilterCandidateLimit": 30,
   "recallFilterMaxItemChars": 500,
   "recallFilterFailOpen": true,

package/clawdbot.plugin.json

@@ -2,7 +2,7 @@
   "id": "memos-cloud-openclaw-plugin",
   "name": "MemOS Cloud OpenClaw Plugin",
   "description": "MemOS Cloud recall + add memory via lifecycle hooks",
-  "version": "0.1.10-beta.0",
+  "version": "0.1.10",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -109,7 +109,47 @@
       },
       "filter": {
         "type": "object",
-        "description": "MemOS search filter"
+        "description": "MemOS search filter",
+        "additionalProperties": true
+      },
+      "relativity": {
+        "type": "number",
+        "description": "Search relativity threshold",
+        "default": 0.45
+      },
+      "recallFilterEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "recallFilterBaseUrl": {
+        "type": "string",
+        "description": "OpenAI-compatible API base URL for recall filtering"
+      },
+      "recallFilterApiKey": {
+        "type": "string"
+      },
+      "recallFilterModel": {
+        "type": "string"
+      },
+      "recallFilterTimeoutMs": {
+        "type": "integer",
+        "default": 30000
+      },
+      "recallFilterRetries": {
+        "type": "integer",
+        "default": 1
+      },
+      "recallFilterCandidateLimit": {
+        "type": "integer",
+        "default": 30
+      },
+      "recallFilterMaxItemChars": {
+        "type": "integer",
+        "default": 500
+      },
+      "recallFilterFailOpen": {
+        "type": "boolean",
+        "default": true
       },
       "knowledgebaseIds": {
         "type": "array",

package/index.js

@@ -326,20 +326,20 @@ async function callRecallFilterModel(cfg, userPrompt, candidatePayload) {
   };
 
   let lastError;
-  const retries = Number.isFinite(cfg.recallFilterRetries) ? Math.max(0, cfg.recallFilterRetries) : 0;
-  const timeoutMs = Number.isFinite(cfg.recallFilterTimeoutMs) ? Math.max(1000, cfg.recallFilterTimeoutMs) : 6000;
+  const retries = Number.isFinite(cfg.recallFilterRetries) ? Math.max(0, cfg.recallFilterRetries) : 1;
+  const timeoutMs = Number.isFinite(cfg.recallFilterTimeoutMs) ? Math.max(1000, cfg.recallFilterTimeoutMs) : 30000;
 
   for (let attempt = 0; attempt <= retries; attempt += 1) {
+    let timeoutId;
     try {
       const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+      timeoutId = setTimeout(() => controller.abort(), timeoutMs);
       const res = await fetch(`${cfg.recallFilterBaseUrl}/chat/completions`, {
         method: "POST",
         headers,
         body: JSON.stringify(body),
         signal: controller.signal,
       });
-      clearTimeout(timeoutId);
       if (!res.ok) {
         throw new Error(`HTTP ${res.status}`);
       }
@@ -351,10 +351,17 @@ async function callRecallFilterModel(cfg, userPrompt, candidatePayload) {
       }
       return parsed;
     } catch (err) {
-      lastError = err;
+      const isAbort = err?.name === "AbortError" || /aborted/i.test(String(err?.message ?? err));
+      lastError = isAbort
+        ? new Error(
+            `timed out after ${timeoutMs}ms (raise recallFilterTimeoutMs; local LLMs often need 30s+ on cold start)`,
+          )
+        : err;
       if (attempt < retries) {
         await sleep(120 * (attempt + 1));
       }
+    } finally {
+      if (timeoutId !== undefined) clearTimeout(timeoutId);
     }
   }
   throw lastError;
@@ -375,7 +382,13 @@ async function maybeFilterRecallData(cfg, data, userPrompt, log) {
 
   try {
     const decision = await callRecallFilterModel(cfg, userPrompt, lists.candidatePayload);
-    return applyRecallDecision(data, decision, lists);
+    const filtered = applyRecallDecision(data, decision, lists);
+    log.info?.(
+      `[memos-cloud] recall filter applied: memory ${lists.memoryList.length}->${filtered.memory_detail_list?.length ?? 0}, ` +
+        `preference ${lists.preferenceList.length}->${filtered.preference_detail_list?.length ?? 0}, ` +
+        `tool_memory ${lists.toolList.length}->${filtered.tool_memory_detail_list?.length ?? 0}`,
+    );
+    return filtered;
   } catch (err) {
     log.warn?.(`[memos-cloud] recall filter failed: ${String(err)}`);
     return cfg.recallFilterFailOpen ? data : { ...data, memory_detail_list: [], preference_detail_list: [], tool_memory_detail_list: [] };

package/lib/memos-cloud-api.js

@@ -246,9 +246,9 @@ export function buildConfig(pluginConfig = {}) {
     recallFilterModel: cfg.recallFilterModel ?? loadEnvVar("MEMOS_RECALL_FILTER_MODEL") ?? "",
     recallFilterTimeoutMs: parseNumber(
       cfg.recallFilterTimeoutMs ?? loadEnvVar("MEMOS_RECALL_FILTER_TIMEOUT_MS"),
-      6000,
+      30000,
     ),
-    recallFilterRetries: parseNumber(cfg.recallFilterRetries ?? loadEnvVar("MEMOS_RECALL_FILTER_RETRIES"), 0),
+    recallFilterRetries: parseNumber(cfg.recallFilterRetries ?? loadEnvVar("MEMOS_RECALL_FILTER_RETRIES"), 1),
     recallFilterCandidateLimit:
       parseNumber(cfg.recallFilterCandidateLimit ?? loadEnvVar("MEMOS_RECALL_FILTER_CANDIDATE_LIMIT"), 30),
     recallFilterMaxItemChars:
@@ -518,12 +518,16 @@ function sanitizeInlineText(text) {
   return String(text).replace(/\r?\n+/g, " ").trim();
 }
 
+function resolveDisplayTime(item) {
+  return item?.update_time ?? item?.create_time;
+}
+
 function formatMemoryLine(item, text, options = {}) {
   const cleaned = sanitizeInlineText(text);
   if (!cleaned) return "";
   const maxChars = options.maxItemChars;
   const truncated = truncate(cleaned, maxChars);
-  const time = formatTime(item?.create_time);
+  const time = formatTime(resolveDisplayTime(item));
   if (time) return `   -[${time}] ${truncated}`;
   return `   - ${truncated}`;
 }
@@ -533,7 +537,7 @@ function formatPreferenceLine(item, text, options = {}) {
   if (!cleaned) return "";
   const maxChars = options.maxItemChars;
   const truncated = truncate(cleaned, maxChars);
-  const time = formatTime(item?.create_time);
+  const time = formatTime(resolveDisplayTime(item));
   const type = normalizePreferenceType(item?.preference_type);
   const typeLabel = type ? ` [${type}]` : "";
   if (time) return `   -[${time}]${typeLabel} ${truncated}`;

package/moltbot.plugin.json

@@ -2,7 +2,7 @@
   "id": "memos-cloud-openclaw-plugin",
   "name": "MemOS Cloud OpenClaw Plugin",
   "description": "MemOS Cloud recall + add memory via lifecycle hooks",
-  "version": "0.1.10-beta.0",
+  "version": "0.1.10",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -109,7 +109,47 @@
       },
       "filter": {
         "type": "object",
-        "description": "MemOS search filter"
+        "description": "MemOS search filter",
+        "additionalProperties": true
+      },
+      "relativity": {
+        "type": "number",
+        "description": "Search relativity threshold",
+        "default": 0.45
+      },
+      "recallFilterEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "recallFilterBaseUrl": {
+        "type": "string",
+        "description": "OpenAI-compatible API base URL for recall filtering"
+      },
+      "recallFilterApiKey": {
+        "type": "string"
+      },
+      "recallFilterModel": {
+        "type": "string"
+      },
+      "recallFilterTimeoutMs": {
+        "type": "integer",
+        "default": 30000
+      },
+      "recallFilterRetries": {
+        "type": "integer",
+        "default": 1
+      },
+      "recallFilterCandidateLimit": {
+        "type": "integer",
+        "default": 30
+      },
+      "recallFilterMaxItemChars": {
+        "type": "integer",
+        "default": 500
+      },
+      "recallFilterFailOpen": {
+        "type": "boolean",
+        "default": true
       },
       "knowledgebaseIds": {
         "type": "array",

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "memos-cloud-openclaw-plugin",
   "name": "MemOS Cloud OpenClaw Plugin",
   "description": "MemOS Cloud recall + add memory via lifecycle hooks",
-  "version": "0.1.10-beta.0",
+  "version": "0.1.10",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -109,7 +109,47 @@
       },
       "filter": {
         "type": "object",
-        "description": "MemOS search filter"
+        "description": "MemOS search filter",
+        "additionalProperties": true
+      },
+      "relativity": {
+        "type": "number",
+        "description": "Search relativity threshold",
+        "default": 0.45
+      },
+      "recallFilterEnabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "recallFilterBaseUrl": {
+        "type": "string",
+        "description": "OpenAI-compatible API base URL for recall filtering"
+      },
+      "recallFilterApiKey": {
+        "type": "string"
+      },
+      "recallFilterModel": {
+        "type": "string"
+      },
+      "recallFilterTimeoutMs": {
+        "type": "integer",
+        "default": 30000
+      },
+      "recallFilterRetries": {
+        "type": "integer",
+        "default": 1
+      },
+      "recallFilterCandidateLimit": {
+        "type": "integer",
+        "default": 30
+      },
+      "recallFilterMaxItemChars": {
+        "type": "integer",
+        "default": 500
+      },
+      "recallFilterFailOpen": {
+        "type": "boolean",
+        "default": true
       },
       "knowledgebaseIds": {
         "type": "array",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memtensor/memos-cloud-openclaw-plugin",
-  "version": "0.1.10-beta.4",
+  "version": "0.1.10",
   "description": "OpenClaw lifecycle plugin for MemOS Cloud (add + recall memory)",
   "scripts": {
     "sync-version": "node scripts/sync-version.js",

package/test/query-strip.test.mjs

@@ -3,6 +3,7 @@ import assert from "node:assert/strict";
 
 import {
   USER_QUERY_MARKER,
+  formatPromptBlockFromData,
   sanitizeAddMessagePayload,
   sanitizeSearchPayload,
   stripOpenClawInjectedPrefix,
@@ -338,3 +339,43 @@ test("sanitizes only user messages in add payload", () => {
     ],
   });
 });
+
+test("formatPromptBlockFromData prefers update_time over create_time", () => {
+  const block = formatPromptBlockFromData({
+    memory_detail_list: [
+      {
+        memory_value: "更新后的记忆",
+        create_time: "2026-03-17 10:00",
+        update_time: "2026-03-18 16:20",
+        relativity: 0.9,
+      },
+    ],
+    preference_detail_list: [
+      {
+        preference: "更新后的偏好",
+        preference_type: "explicit",
+        create_time: "2026-03-17 11:00",
+        update_time: "2026-03-18 16:21",
+        relativity: 0.9,
+      },
+    ],
+  });
+
+  assert.match(block, /\-\[2026-03-18 16:20\] 更新后的记忆/);
+  assert.match(block, /\-\[2026-03-18 16:21\] \[Explicit Preference\] 更新后的偏好/);
+});
+
+test("formatPromptBlockFromData falls back to create_time when update_time is missing", () => {
+  const block = formatPromptBlockFromData({
+    memory_detail_list: [
+      {
+        memory_value: "只有创建时间",
+        create_time: "2026-03-18 09:30",
+        relativity: 0.9,
+      },
+    ],
+    preference_detail_list: [],
+  });
+
+  assert.match(block, /\-\[2026-03-18 09:30\] 只有创建时间/);
+});