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

package/README.md

@@ -44,7 +44,7 @@ Make sure it’s enabled in `~/.openclaw/openclaw.json`:
     },
     "load": {
       "paths": [
-        "C:\\Users\\YourName\\.openclaw\\extensions\\memos-cloud-openclaw-plugin\\package"
+        "C:\\Users\\YourName\\.openclaw\\extensions\\memos-cloud-openclaw-plugin"
       ]
     }
   }
@@ -106,6 +106,11 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `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)
+- `MEMOS_CAPTURE_STRATEGY` (default: `last_turn`)
+- `MEMOS_ASYNC_MODE` (default: `true`; non-blocking memory addition)
+- `MEMOS_THROTTLE_MS` (default: `0`; throttle memory requests)
+- `MEMOS_INCLUDE_ASSISTANT` (default: `true`; include assistant messages in memory)
+- `MEMOS_MAX_MESSAGE_CHARS` (default: `20000`; max characters for message history)
 
 ## Optional Plugin Config
 In `plugins.entries.memos-cloud-openclaw-plugin.config`:
@@ -145,7 +150,9 @@ In `plugins.entries.memos-cloud-openclaw-plugin.config`:
   "recallFilterRetries": 0,
   "recallFilterCandidateLimit": 30,
   "recallFilterMaxItemChars": 500,
-  "recallFilterFailOpen": true
+  "recallFilterFailOpen": true,
+  "throttleMs": 0,
+  "maxMessageChars": 20000
 }
 ```
 

package/README_ZH.md

@@ -46,7 +46,7 @@ openclaw gateway restart
     },
     "load": {
       "paths": [
-        "C:\\Users\\YourName\\.openclaw\\extensions\\memos-cloud-openclaw-plugin\\package"
+        "C:\\Users\\YourName\\.openclaw\\extensions\\memos-cloud-openclaw-plugin"
       ]
     }
   }
@@ -108,6 +108,11 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `MEMOS_RECALL_FILTER_CANDIDATE_LIMIT`（默认每类 `30` 条）
 - `MEMOS_RECALL_FILTER_MAX_ITEM_CHARS`（默认 `500`）
 - `MEMOS_RECALL_FILTER_FAIL_OPEN`（默认 `true`；筛选失败时回退为“不过滤”）
+- `MEMOS_CAPTURE_STRATEGY`（默认 `last_turn`；记忆捕获策略）
+- `MEMOS_ASYNC_MODE`（默认 `true`；异步模式添加记忆）
+- `MEMOS_THROTTLE_MS`（默认 `0`；请求节流时间，单位毫秒）
+- `MEMOS_INCLUDE_ASSISTANT`（默认 `true`；记忆是否包含助手回复）
+- `MEMOS_MAX_MESSAGE_CHARS`（默认 `20000`；单条记忆最大字符数限制）
 
 ## 可选插件配置
 在 `plugins.entries.memos-cloud-openclaw-plugin.config` 中设置：
@@ -145,7 +150,9 @@ MEMOS_API_KEY=YOUR_TOKEN
   "recallFilterRetries": 0,
   "recallFilterCandidateLimit": 30,
   "recallFilterMaxItemChars": 500,
-  "recallFilterFailOpen": true
+  "recallFilterFailOpen": true,
+  "throttleMs": 0,
+  "maxMessageChars": 20000
 }
 ```
 

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.9",
+  "version": "0.1.10-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {

package/index.js

@@ -5,8 +5,8 @@ import {
   extractResultData,
   extractText,
   formatRecallHookResult,
-  USER_QUERY_MARKER,
   searchMemory,
+  stripOpenClawInjectedPrefix,
 } from "./lib/memos-cloud-api.js";
 import { startUpdateChecker } from "./lib/check-update.js";
 let lastCaptureTime = 0;
@@ -32,14 +32,7 @@ function warnMissingApiKey(log, context) {
     ].join("\n"),
   );
 }
-
-function stripPrependedPrompt(content) {
-  if (!content) return content;
-  const idx = content.lastIndexOf(USER_QUERY_MARKER);
-  if (idx === -1) return content;
-  return content.slice(idx + USER_QUERY_MARKER.length).trimStart();
-}
-
+console.log('11111111111111111111111111111111')
 function getCounterSuffix(sessionKey) {
   if (!sessionKey) return "";
   const current = conversationCounters.get(sessionKey) ?? 0;
@@ -73,7 +66,8 @@ function resolveConversationId(cfg, ctx) {
 }
 
 function buildSearchPayload(cfg, prompt, ctx) {
-  const queryRaw = `${cfg.queryPrefix || ""}${prompt}`;
+  const cleanPrompt = stripOpenClawInjectedPrefix(prompt);
+  const queryRaw = `${cfg.queryPrefix || ""}${cleanPrompt}`;
   const query =
     Number.isFinite(cfg.maxQueryChars) && cfg.maxQueryChars > 0
       ? queryRaw.slice(0, cfg.maxQueryChars)
@@ -162,7 +156,7 @@ function pickLastTurnMessages(messages, cfg) {
   for (const msg of slice) {
     if (!msg || !msg.role) continue;
     if (msg.role === "user") {
-      const content = stripPrependedPrompt(extractText(msg.content));
+      const content = stripOpenClawInjectedPrefix(extractText(msg.content));
       if (content) results.push({ role: "user", content: truncate(content, cfg.maxMessageChars) });
       continue;
     }
@@ -180,7 +174,7 @@ function pickFullSessionMessages(messages, cfg) {
   for (const msg of messages) {
     if (!msg || !msg.role) continue;
     if (msg.role === "user") {
-      const content = stripPrependedPrompt(extractText(msg.content));
+      const content = stripOpenClawInjectedPrefix(extractText(msg.content));
       if (content) results.push({ role: "user", content: truncate(content, cfg.maxMessageChars) });
     }
     if (msg.role === "assistant" && cfg.includeAssistant) {
@@ -426,18 +420,19 @@ export default {
 
     api.on("before_agent_start", async (event, ctx) => {
       if (!cfg.recallEnabled) return;
-      if (!event?.prompt || event.prompt.length < 3) return;
+      const userPrompt = stripOpenClawInjectedPrefix(event?.prompt || "");
+      if (!userPrompt || userPrompt.length < 3) return;
       if (!cfg.apiKey) {
         warnMissingApiKey(log, "recall");
         return;
       }
 
       try {
-        const payload = buildSearchPayload(cfg, event.prompt, ctx);
+        const payload = buildSearchPayload(cfg, userPrompt, ctx);
         const result = await searchMemory(cfg, payload);
         const resultData = extractResultData(result);
         if (!resultData) return;
-        const filteredData = await maybeFilterRecallData(cfg, resultData, event.prompt, log);
+        const filteredData = await maybeFilterRecallData(cfg, resultData, userPrompt, log);
         const hookResult = formatRecallHookResult({ data: filteredData }, {
           wrapTagBlocks: true,
           relativity: payload.relativity,
@@ -453,6 +448,7 @@ export default {
 
     api.on("agent_end", async (event, ctx) => {
       if (!cfg.addEnabled) return;
+      console.log('222222222222222222222\n22222222222', cfg.addEnabled)
       if (!event?.success || !event?.messages?.length) return;
       if (!cfg.apiKey) {
         warnMissingApiKey(log, "add");

package/lib/memos-cloud-api.js

@@ -5,6 +5,18 @@ import { setTimeout as delay } from "node:timers/promises";
 
 const DEFAULT_BASE_URL = "https://memos.memtensor.cn/api/openmem/v1";
 export const USER_QUERY_MARKER = "user\u200b原\u200b始\u200bquery\u200b：\u200b\u200b\u200b\u200b";
+const INBOUND_META_SENTINELS = [
+  "Conversation info (untrusted metadata):",
+  "Sender (untrusted metadata):",
+  "Thread starter (untrusted, for context):",
+  "Replied message (untrusted, for context):",
+  "Forwarded message context (untrusted metadata):",
+  "Chat history since last reply (untrusted, for context):",
+];
+const LEADING_TIMESTAMP_ENVELOPE_PATTERNS = [
+  /^\[(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}(?:\s+GMT[+-]\d{1,2})?\]\s*/,
+  /^\[\d{1,2}:\d{2}\s*(?:AM|PM)\s+on\s+\d{1,2}\s+[A-Za-z]+,\s+\d{4}\]:\s*/i,
+];
 const ENV_SOURCES = [
   { name: "openclaw", path: join(homedir(), ".openclaw", ".env") },
   { name: "moltbot", path: join(homedir(), ".moltbot", ".env") },
@@ -161,6 +173,14 @@ export function buildConfig(pluginConfig = {}) {
     cfg.recallFilterFailOpen,
     parseBool(loadEnvVar("MEMOS_RECALL_FILTER_FAIL_OPEN"), true),
   );
+  const captureStrategy = cfg.captureStrategy ?? (loadEnvVar("MEMOS_CAPTURE_STRATEGY") || "last_turn");
+  const asyncMode = cfg.asyncMode ?? parseBool(loadEnvVar("MEMOS_ASYNC_MODE"), true);
+  const throttleMs = cfg.throttleMs ?? parseNumber(loadEnvVar("MEMOS_THROTTLE_MS"), 0);
+  const includeAssistant =
+    cfg.includeAssistant === undefined
+      ? parseBool(loadEnvVar("MEMOS_INCLUDE_ASSISTANT"), true)
+      : cfg.includeAssistant !== false;
+  const maxMessageChars = cfg.maxMessageChars ?? parseNumber(loadEnvVar("MEMOS_MAX_MESSAGE_CHARS"), 20000);
 
   return {
     baseUrl: baseUrl.replace(/\/+$/, ""),
@@ -177,10 +197,10 @@ export function buildConfig(pluginConfig = {}) {
     maxQueryChars: cfg.maxQueryChars ?? 0,
     recallEnabled: cfg.recallEnabled !== false,
     addEnabled: cfg.addEnabled !== false,
-    captureStrategy: cfg.captureStrategy ?? "last_turn",
-    maxMessageChars: cfg.maxMessageChars ?? 20000,
+    captureStrategy,
+    maxMessageChars,
     maxItemChars: cfg.maxItemChars ?? 8000,
-    includeAssistant: cfg.includeAssistant !== false,
+    includeAssistant,
     memoryLimitNumber: cfg.memoryLimitNumber ?? 9,
     preferenceLimitNumber: cfg.preferenceLimitNumber ?? 6,
     includePreference: cfg.includePreference !== false,
@@ -198,7 +218,7 @@ export function buildConfig(pluginConfig = {}) {
     appId: cfg.appId,
     allowPublic: cfg.allowPublic ?? false,
     allowKnowledgebaseIds: cfg.allowKnowledgebaseIds ?? [],
-    asyncMode: cfg.asyncMode ?? true,
+    asyncMode,
     multiAgentMode,
     recallFilterEnabled,
     recallFilterBaseUrl:
@@ -217,7 +237,7 @@ export function buildConfig(pluginConfig = {}) {
     recallFilterFailOpen,
     timeoutMs: cfg.timeoutMs ?? 5000,
     retries: cfg.retries ?? 1,
-    throttleMs: cfg.throttleMs ?? 0,
+    throttleMs,
   };
 }
 
@@ -267,7 +287,111 @@ export async function searchMemory(cfg, payload) {
 }
 
 export async function addMessage(cfg, payload) {
-  return callApi(cfg, "/add/message", payload);
+  let finalPayload = payload;
+  try {
+    finalPayload = sanitizeAddMessagePayload(payload);
+  } catch {
+    // Fail open: if sanitization throws unexpectedly, send original payload.
+    finalPayload = payload;
+  }
+  return callApi(cfg, "/add/message", finalPayload);
+}
+
+function isInboundMetaSentinelLine(line) {
+  const trimmed = line.trim();
+  return INBOUND_META_SENTINELS.some((sentinel) => sentinel === trimmed);
+}
+
+function stripLeadingInboundMetadata(text) {
+  if (!text || typeof text !== "string") return "";
+  const lines = text.split(/\r?\n/);
+  let index = 0;
+  let strippedAny = false;
+
+  while (index < lines.length && lines[index].trim() === "") {
+    index += 1;
+  }
+  if (index >= lines.length || !isInboundMetaSentinelLine(lines[index])) {
+    return text;
+  }
+
+  while (index < lines.length) {
+    if (!isInboundMetaSentinelLine(lines[index])) break;
+    const blockStart = index;
+    index += 1;
+    if (index >= lines.length || lines[index].trim() !== "```json") {
+      return strippedAny ? lines.slice(blockStart).join("\n") : text;
+    }
+    index += 1;
+    while (index < lines.length && lines[index].trim() !== "```") {
+      index += 1;
+    }
+    if (index >= lines.length) {
+      return strippedAny ? lines.slice(blockStart).join("\n") : text;
+    }
+    index += 1;
+    strippedAny = true;
+    while (index < lines.length && lines[index].trim() === "") {
+      index += 1;
+    }
+  }
+
+  return lines.slice(index).join("\n");
+}
+
+function stripLeadingTimestampEnvelope(text) {
+  if (!text || typeof text !== "string") return "";
+  for (const pattern of LEADING_TIMESTAMP_ENVELOPE_PATTERNS) {
+    if (!pattern.test(text)) continue;
+    return text.replace(pattern, "").trimStart();
+  }
+  return text;
+}
+
+function stripFeishuInjectedPrompt(text) {
+  if (!text || typeof text !== "string") return text;
+  // Check for the Feishu System header
+  if (!/^System: \[.*?\] Feishu\[.*?\]/.test(text)) {
+    return text;
+  }
+  // Remove only the first injected Feishu prompt prefix.
+  // Any later "[message_id] ou_xxx:" pattern should be treated as user query content.
+  const leadingInjectedPattern = /^[\s\S]*?\[message_id: [^\]]+\]\s+ou_[a-z0-9]+:\s*/;
+  if (leadingInjectedPattern.test(text)) {
+    return text.replace(leadingInjectedPattern, "").trim();
+  }
+  return text;
+}
+
+function sanitizeAddMessagePayload(payload) {
+  if (!payload || typeof payload !== "object") return payload;
+  const nextPayload = { ...payload };
+  if (typeof nextPayload.query === "string") {
+    nextPayload.query = stripOpenClawInjectedPrefix(nextPayload.query);
+  }
+  if (Array.isArray(nextPayload.messages)) {
+    nextPayload.messages = nextPayload.messages.map((msg) => {
+      if (!msg || typeof msg !== "object") return msg;
+      if (msg.role !== "user" || typeof msg.content !== "string") return msg;
+      return {
+        ...msg,
+        content: stripOpenClawInjectedPrefix(msg.content),
+      };
+    });
+  }
+  return nextPayload;
+}
+
+export function stripOpenClawInjectedPrefix(text) {
+  if (!text || typeof text !== "string") return "";
+  const cleanedText = stripFeishuInjectedPrompt(text);
+  const markerIndex = cleanedText.lastIndexOf(USER_QUERY_MARKER);
+  const withoutRecallPrefix =
+    markerIndex === -1
+      ? cleanedText
+      : cleanedText.slice(markerIndex + USER_QUERY_MARKER.length);
+  const withoutInboundMetadata = stripLeadingInboundMetadata(withoutRecallPrefix).trimStart();
+  return stripLeadingTimestampEnvelope(withoutInboundMetadata);
 }
 
 export function extractText(content) {

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.9",
+  "version": "0.1.10-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {

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.9",
+  "version": "0.1.10-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {

package/package.json

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

package/test/query-strip.test.mjs

@@ -0,0 +1,143 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  USER_QUERY_MARKER,
+  stripOpenClawInjectedPrefix,
+} from "../lib/memos-cloud-api.js";
+
+test("leaves plain user text unchanged", () => {
+  assert.equal(stripOpenClawInjectedPrefix("直接就是用户问题"), "直接就是用户问题");
+});
+
+test("strips MemOS recall marker and keeps original query", () => {
+  const input = `<memories>\n  <facts>\n  </facts>\n</memories>\n\n${USER_QUERY_MARKER}真正的问题`;
+  assert.equal(stripOpenClawInjectedPrefix(input), "真正的问题");
+});
+
+test("strips OpenClaw inbound metadata prefix blocks", () => {
+  const input = [
+    "Conversation info (untrusted metadata):",
+    "```json",
+    '{"message_id":"123"}',
+    "```",
+    "",
+    "Sender (untrusted metadata):",
+    "```json",
+    '{"label":"Aurora"}',
+    "```",
+    "",
+    "帮我看下这个问题",
+  ].join("\n");
+
+  assert.equal(stripOpenClawInjectedPrefix(input), "帮我看下这个问题");
+});
+
+test("strips recall marker and inbound metadata together", () => {
+  const input = [
+    "<memories>",
+    "  <facts>",
+    "  </facts>",
+    "</memories>",
+    "",
+    `${USER_QUERY_MARKER}Conversation info (untrusted metadata):`,
+    "```json",
+    '{"message_id":"123","history_count":1}',
+    "```",
+    "",
+    "Chat history since last reply (untrusted, for context):",
+    "```json",
+    '[{"sender":"Aurora","body":"上一条"}]',
+    "```",
+    "",
+    "继续",
+  ].join("\n");
+
+  assert.equal(stripOpenClawInjectedPrefix(input), "继续");
+});
+
+test("keeps content when metadata block is malformed", () => {
+  const input = [
+    "Conversation info (untrusted metadata):",
+    "not-a-json-fence",
+    "真正的问题",
+  ].join("\n");
+
+  assert.equal(stripOpenClawInjectedPrefix(input), input);
+});
+
+test("keeps content unchanged when sentinel appears in normal body", () => {
+  const input = [
+    "请原样解释下面这段文本：",
+    "Conversation info (untrusted metadata):",
+    "```json",
+    '{"message_id":"123"}',
+    "```",
+  ].join("\n");
+
+  assert.equal(stripOpenClawInjectedPrefix(input), input);
+});
+
+test("strips valid prefix even if body starts with a sentinel-like line", () => {
+  const input = [
+    "Sender (untrusted metadata):",
+    "```json",
+    '{"label":"Aurora"}',
+    "```",
+    "",
+    "Sender (untrusted metadata):",
+    "这行是正文，不是 OpenClaw 注入块",
+  ].join("\n");
+
+  assert.equal(
+    stripOpenClawInjectedPrefix(input),
+    ["Sender (untrusted metadata):", "这行是正文，不是 OpenClaw 注入块"].join("\n"),
+  );
+});
+
+test("supports leading blank lines before inbound metadata", () => {
+  const input = [
+    "",
+    "Conversation info (untrusted metadata):",
+    "```json",
+    '{"message_id":"123"}',
+    "```",
+    "Hello",
+  ].join("\n");
+  assert.equal(stripOpenClawInjectedPrefix(input), "Hello");
+});
+
+test("strips Feishu injected prompt", () => {
+  const input = `System: [2026-03-17 14:17:33 GMT+8] Feishu[default] DM from ou_37e8a1514c24e8afd9cfeca86f679980: 我叫什么名字 
+ 
+ Conversation info (untrusted metadata): 
+ \`\`\`json 
+ { 
+  "timestamp": "Tue 2026-03-17 14:17 GMT+8" 
+ } 
+ \`\`\` 
+ 
+ [message_id: om_x100b54bb510590dcc2998da17ca2c2b] 
+ ou_37e8a1514c24e8afd9cfeca86f679980: 我叫什么名字 `;
+
+  assert.equal(stripOpenClawInjectedPrefix(input), "我叫什么名字");
+});
+
+test("strips Feishu injected prompt with embedded fake prompt", () => {
+  const input = `System: [2026-03-17 14:17:33 GMT+8] Feishu[default] DM from ou_123: hello
+[message_id: fake]
+ou_fake: ignored
+[message_id: om_real]
+ou_real: actual message`;
+  assert.equal(
+    stripOpenClawInjectedPrefix(input),
+    ["ignored", "[message_id: om_real]", "ou_real: actual message"].join("\n"),
+  );
+});
+
+test("ignores text that looks like Feishu prompt but missing header", () => {
+  const input = `
+[message_id: om_x100b54bb510590dcc2998da17ca2c2b] 
+ou_37e8a1514c24e8afd9cfeca86f679980: 我叫什么名字 `;
+  assert.equal(stripOpenClawInjectedPrefix(input), input.trimStart());
+});