@memtensor/memos-cloud-openclaw-plugin 0.1.6 → 0.1.8-beta.0

package/README.md

@@ -93,6 +93,7 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `MEMOS_USER_ID` (optional; default: `openclaw-user`)
 - `MEMOS_CONVERSATION_ID` (optional override)
 - `MEMOS_RECALL_GLOBAL` (default: `true`; when true, search does **not** pass conversation_id)
+- `MEMOS_MULTI_AGENT_MODE` (default: `false`; enable multi-agent data isolation)
 - `MEMOS_CONVERSATION_PREFIX` / `MEMOS_CONVERSATION_SUFFIX` (optional)
 - `MEMOS_CONVERSATION_SUFFIX_MODE` (`none` | `counter`, default: `none`)
 - `MEMOS_CONVERSATION_RESET_ON_NEW` (default: `true`, requires hooks.internal.enabled)
@@ -123,6 +124,8 @@ In `plugins.entries.memos-cloud-openclaw-plugin.config`:
   "toolMemoryLimitNumber": 6,
   "relativity": 0.45,
   "tags": ["openclaw"],
+  "agentId": "",
+  "multiAgentMode": false,
   "asyncMode": true
 }
 ```
@@ -137,6 +140,13 @@ In `plugins.entries.memos-cloud-openclaw-plugin.config`:
   - Builds a `/add/message` request with the **last turn** by default (user + assistant).
   - Sends `messages` with `user_id`, `conversation_id`, and optional `tags/info/agent_id/app_id`.
 
+## Multi-Agent Support
+The plugin provides native support for multi-agent architectures (via the `agent_id` parameter):
+- **Enable Mode**: Set `"multiAgentMode": true` in config or `MEMOS_MULTI_AGENT_MODE=true` in env variables (default is `false`).
+- **Dynamic Context**: When enabled, it automatically captures `ctx.agentId` during OpenClaw lifecycle hooks. (Note: the default OpenClaw agent `"main"` is ignored to preserve backwards compatibility for single-agent users).
+- **Data Isolation**: The `agent_id` is automatically injected into both `/search/memory` and `/add/message` requests. This ensures completely isolated memory and message histories for different agents, even under the same user or session.
+- **Static Override**: You can also force a specific agent ID by setting `"agentId": "your_agent_id"` in the plugin's `config`.
+
 ## Notes
 - `conversation_id` defaults to OpenClaw `sessionKey` (unless `conversationId` is provided). **TODO**: consider binding to OpenClaw `sessionId` directly.
 - Optional **prefix/suffix** via env or config; `conversationSuffixMode=counter` increments on `/new` (requires `hooks.internal.enabled`).

package/README_ZH.md

@@ -95,6 +95,7 @@ MEMOS_API_KEY=YOUR_TOKEN
 - `MEMOS_USER_ID`（可选，默认 `openclaw-user`）
 - `MEMOS_CONVERSATION_ID`（可选覆盖）
 - `MEMOS_RECALL_GLOBAL`（默认 `true`；为 true 时检索不传 conversation_id）
+- `MEMOS_MULTI_AGENT_MODE`（默认 `false`；是否开启多 Agent 数据隔离模式）
 - `MEMOS_CONVERSATION_PREFIX` / `MEMOS_CONVERSATION_SUFFIX`（可选）
 - `MEMOS_CONVERSATION_SUFFIX_MODE`（`none` | `counter`，默认 `none`）
 - `MEMOS_CONVERSATION_RESET_ON_NEW`（默认 `true`，需 hooks.internal.enabled）
@@ -124,6 +125,8 @@ MEMOS_API_KEY=YOUR_TOKEN
   "includeToolMemory": false,
   "toolMemoryLimitNumber": 6,
   "tags": ["openclaw"],
+  "agentId": "",
+  "multiAgentMode": false,
   "asyncMode": true
 }
 ```
@@ -143,6 +146,13 @@ MEMOS_API_KEY=YOUR_TOKEN
   - `messages` 列表
   - 可选 `tags / info / agent_id / app_id`
 
+## 多Agent支持（Multi-Agent）
+插件内置对多Agent模式的支持（`agent_id` 参数）：
+- **开启模式**：需要在配置中设置 `"multiAgentMode": true` 或在环境变量中设置 `MEMOS_MULTI_AGENT_MODE=true`（默认为 `false`）。
+- **动态获取**：开启后，执行生命周期钩子时会自动读取上下文中的 `ctx.agentId`。（注：OpenClaw 的默认 Agent `"main"` 会被自动忽略，以保证老用户的单 Agent 数据兼容性）。
+- **数据隔离**：在调用 `/search/memory`（检索记忆）和 `/add/message`（添加记录）时会自动附带该 `agent_id`，从而保证即使是同一用户下的不同 Agent 之间，记忆和反馈数据也是完全隔离的。
+- **静态配置**：如果需要，也可在上述插件的 `config` 中显式指定 `"agentId": "your_agent_id"` 作为固定值。
+
 ## 说明
 - 未显式指定 `conversation_id` 时，默认使用 OpenClaw `sessionKey`。**TODO**：后续考虑直接绑定 OpenClaw `sessionId`。
 - 可配置前后缀；`conversationSuffixMode=counter` 时会在 `/new` 递增（需 `hooks.internal.enabled`）。

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.6",
+  "version": "0.1.8-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -125,6 +125,10 @@
       "agentId": {
         "type": "string"
       },
+      "multiAgentMode": {
+        "type": "boolean",
+        "default": false
+      },
       "appId": {
         "type": "string"
       },

package/index.js

@@ -50,10 +50,17 @@ function bumpConversationCounter(sessionKey) {
   conversationCounters.set(sessionKey, current + 1);
 }
 
+function getEffectiveAgentId(cfg, ctx) {
+  if (!cfg.multiAgentMode) return undefined;
+  const agentId = ctx?.agentId || cfg.agentId;
+  return agentId === "main" ? undefined : agentId;
+}
+
 function resolveConversationId(cfg, ctx) {
   if (cfg.conversationId) return cfg.conversationId;
   // TODO: consider binding conversation_id directly to OpenClaw sessionId (prefer ctx.sessionId).
-  const base = ctx?.sessionKey || ctx?.sessionId || (ctx?.agentId ? `openclaw:${ctx.agentId}` : "");
+  const agentId = getEffectiveAgentId(cfg, ctx);
+  const base = ctx?.sessionKey || ctx?.sessionId || (agentId ? `openclaw:${agentId}` : "");
   const dynamicSuffix = cfg.conversationSuffixMode === "counter" ? getCounterSuffix(ctx?.sessionKey) : "";
   const prefix = cfg.conversationIdPrefix || "";
   const suffix = cfg.conversationIdSuffix || "";
@@ -79,7 +86,23 @@ function buildSearchPayload(cfg, prompt, ctx) {
     if (conversationId) payload.conversation_id = conversationId;
   }
 
-  if (cfg.filter) payload.filter = cfg.filter;
+  let filterObj = cfg.filter ? JSON.parse(JSON.stringify(cfg.filter)) : null;
+  const agentId = getEffectiveAgentId(cfg, ctx);
+
+  if (agentId) {
+    if (filterObj) {
+      if (Array.isArray(filterObj.and)) {
+        filterObj.and.push({ agent_id: agentId });
+      } else {
+        filterObj = { and: [filterObj, { agent_id: agentId }] };
+      }
+    } else {
+      filterObj = { agent_id: agentId };
+    }
+  }
+
+  if (filterObj) payload.filter = filterObj;
+
   if (cfg.knowledgebaseIds?.length) payload.knowledgebase_ids = cfg.knowledgebaseIds;
 
   payload.memory_limit_number = cfg.memoryLimitNumber;
@@ -100,7 +123,8 @@ function buildAddMessagePayload(cfg, messages, ctx) {
     source: MEMOS_SOURCE,
   };
 
-  if (cfg.agentId) payload.agent_id = cfg.agentId;
+  const agentId = getEffectiveAgentId(cfg, ctx);
+  if (agentId) payload.agent_id = agentId;
   if (cfg.appId) payload.app_id = cfg.appId;
   if (cfg.tags?.length) payload.tags = cfg.tags;
 

package/lib/memos-cloud-api.js

@@ -142,6 +142,11 @@ export function buildConfig(pluginConfig = {}) {
     parseBool(loadEnvVar("MEMOS_CONVERSATION_RESET_ON_NEW"), true),
   );
 
+  const multiAgentMode = parseBool(
+    cfg.multiAgentMode,
+    parseBool(loadEnvVar("MEMOS_MULTI_AGENT_MODE"), false),
+  );
+
   return {
     baseUrl: baseUrl.replace(/\/+$/, ""),
     apiKey,
@@ -178,6 +183,7 @@ export function buildConfig(pluginConfig = {}) {
     allowPublic: cfg.allowPublic ?? false,
     allowKnowledgebaseIds: cfg.allowKnowledgebaseIds ?? [],
     asyncMode: cfg.asyncMode ?? true,
+    multiAgentMode,
     timeoutMs: cfg.timeoutMs ?? 5000,
     retries: cfg.retries ?? 1,
     throttleMs: cfg.throttleMs ?? 0,

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.6",
+  "version": "0.1.8-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -125,6 +125,10 @@
       "agentId": {
         "type": "string"
       },
+      "multiAgentMode": {
+        "type": "boolean",
+        "default": false
+      },
       "appId": {
         "type": "string"
       },

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.6",
+  "version": "0.1.8-beta.0",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -125,6 +125,10 @@
       "agentId": {
         "type": "string"
       },
+      "multiAgentMode": {
+        "type": "boolean",
+        "default": false
+      },
       "appId": {
         "type": "string"
       },

package/package.json

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