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

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.11-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -41,6 +41,11 @@
         ],
         "default": "none"
       },
+      "useDirectSessionUserId": {
+        "type": "boolean",
+        "description": "When enabled, direct-session keys like agent:main:<provider>:direct:<id> use the direct id as MemOS user_id instead of the default configured userId.",
+        "default": false
+      },
       "resetOnNew": {
         "type": "boolean",
         "default": true
@@ -109,7 +114,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",
@@ -134,6 +179,13 @@
         "type": "boolean",
         "default": false
       },
+      "allowedAgents": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "When multiAgentMode is true, only these agent IDs will activate the memory plugin. Comma-separated in env var MEMOS_ALLOWED_AGENTS. Empty list means all agents are allowed."
+      },
       "appId": {
         "type": "string"
       },
@@ -162,6 +214,108 @@
       "throttleMs": {
         "type": "integer",
         "default": 0
+      },
+      "agentOverrides": {
+        "type": "object",
+        "description": "Per-agent config overrides. Keys are agent IDs, values override global defaults for that agent.",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "knowledgebaseIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "memoryLimitNumber": {
+              "type": "integer"
+            },
+            "preferenceLimitNumber": {
+              "type": "integer"
+            },
+            "includePreference": {
+              "type": "boolean"
+            },
+            "includeToolMemory": {
+              "type": "boolean"
+            },
+            "toolMemoryLimitNumber": {
+              "type": "integer"
+            },
+            "includeSkill": {
+              "type": "boolean"
+            },
+            "skillLimitNumber": {
+              "type": "integer"
+            },
+            "relativity": {
+              "type": "number"
+            },
+            "filter": {
+              "type": "object",
+              "additionalProperties": true
+            },
+            "recallEnabled": {
+              "type": "boolean"
+            },
+            "addEnabled": {
+              "type": "boolean"
+            },
+            "captureStrategy": {
+              "type": "string",
+              "enum": [
+                "last_turn",
+                "full_session"
+              ]
+            },
+            "queryPrefix": {
+              "type": "string"
+            },
+            "maxQueryChars": {
+              "type": "integer"
+            },
+            "maxItemChars": {
+              "type": "integer"
+            },
+            "maxMessageChars": {
+              "type": "integer"
+            },
+            "includeAssistant": {
+              "type": "boolean"
+            },
+            "recallGlobal": {
+              "type": "boolean"
+            },
+            "recallFilterEnabled": {
+              "type": "boolean"
+            },
+            "recallFilterModel": {
+              "type": "string"
+            },
+            "recallFilterBaseUrl": {
+              "type": "string"
+            },
+            "recallFilterApiKey": {
+              "type": "string"
+            },
+            "allowKnowledgebaseIds": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "tags": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "throttleMs": {
+              "type": "integer"
+            }
+          },
+          "additionalProperties": false
+        }
       }
     },
     "additionalProperties": false

package/package.json

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

package/test/direct-session-user-id.test.mjs

@@ -0,0 +1,94 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import { buildConfig } from "../lib/memos-cloud-api.js";
+import {
+  buildAddMessagePayload,
+  buildSearchPayload,
+  extractDirectSessionUserId,
+  resolveMemosUserId,
+} from "../index.js";
+
+test("buildConfig keeps useDirectSessionUserId disabled by default", () => {
+  const previous = process.env.MEMOS_USE_DIRECT_SESSION_USER_ID;
+  delete process.env.MEMOS_USE_DIRECT_SESSION_USER_ID;
+  try {
+    const cfg = buildConfig({});
+    assert.equal(cfg.useDirectSessionUserId, false);
+  } finally {
+    if (previous === undefined) {
+      delete process.env.MEMOS_USE_DIRECT_SESSION_USER_ID;
+    } else {
+      process.env.MEMOS_USE_DIRECT_SESSION_USER_ID = previous;
+    }
+  }
+});
+
+test("extractDirectSessionUserId returns the id for direct session keys", () => {
+  assert.equal(
+    extractDirectSessionUserId("agent:main:discord:direct:1160853368999247882"),
+    "1160853368999247882",
+  );
+  assert.equal(extractDirectSessionUserId("agent:main:telegram:direct:8361983702"), "8361983702");
+});
+
+test("extractDirectSessionUserId ignores non-direct session keys", () => {
+  assert.equal(extractDirectSessionUserId("agent:main:discord:channel:1482035270651220051"), "");
+  assert.equal(extractDirectSessionUserId(""), "");
+});
+
+test("resolveMemosUserId falls back to configured userId when switch is off", () => {
+  const cfg = { userId: "openclaw-user", useDirectSessionUserId: false };
+  const ctx = { sessionKey: "agent:main:discord:direct:1160853368999247882" };
+  assert.equal(resolveMemosUserId(cfg, ctx), "openclaw-user");
+});
+
+test("resolveMemosUserId uses direct id when switch is on", () => {
+  const cfg = { userId: "openclaw-user", useDirectSessionUserId: true };
+  const ctx = { sessionKey: "agent:main:discord:direct:1160853368999247882" };
+  assert.equal(resolveMemosUserId(cfg, ctx), "1160853368999247882");
+});
+
+test("buildSearchPayload uses direct session id as user_id for private chats", () => {
+  const cfg = {
+    userId: "openclaw-user",
+    useDirectSessionUserId: true,
+    queryPrefix: "",
+    maxQueryChars: 0,
+    recallGlobal: true,
+    knowledgebaseIds: [],
+    memoryLimitNumber: 6,
+    includePreference: true,
+    preferenceLimitNumber: 6,
+    includeToolMemory: false,
+    toolMemoryLimitNumber: 0,
+    relativity: 0.45,
+    multiAgentMode: false,
+  };
+  const ctx = { sessionKey: "agent:main:discord:direct:1160853368999247882" };
+
+  const payload = buildSearchPayload(cfg, "你好", ctx);
+  assert.equal(payload.user_id, "1160853368999247882");
+});
+
+test("buildAddMessagePayload keeps configured userId for non-direct chats", () => {
+  const cfg = {
+    userId: "openclaw-user",
+    useDirectSessionUserId: true,
+    multiAgentMode: false,
+    appId: "",
+    tags: [],
+    info: {},
+    allowPublic: false,
+    allowKnowledgebaseIds: [],
+    asyncMode: true,
+    conversationId: "",
+    conversationIdPrefix: "",
+    conversationIdSuffix: "",
+    conversationSuffixMode: "none",
+  };
+  const ctx = { sessionKey: "agent:main:discord:channel:1482035270651220051" };
+
+  const payload = buildAddMessagePayload(cfg, [{ role: "user", content: "hi" }], ctx);
+  assert.equal(payload.user_id, "openclaw-user");
+});

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\] 只有创建时间/);
+});