@memtensor/memos-cloud-openclaw-plugin 0.1.21-beta.0 → 0.1.22

package/README.md

@@ -21,15 +21,16 @@ A minimal OpenClaw lifecycle plugin that **recalls** memories from MemOS Cloud b
 
 ## Install
 
-### Option A — Install from NPM
-
+### Option A — NPM (Recommended)
 ```bash
 openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest
 openclaw gateway restart
 ```
 
-Make sure it’s enabled in `~/.openclaw/openclaw.json`:
+> **Note for Windows Users**:
+> If you encounter `Error: spawn EINVAL`, this is a known issue with OpenClaw's plugin installer on Windows. Please use **Option B** (Manual Install) below.
 
+Make sure it’s enabled in `~/.openclaw/openclaw.json`:
 ```json
 {
   "plugins": {
@@ -40,17 +41,28 @@ Make sure it’s enabled in `~/.openclaw/openclaw.json`:
 }
 ```
 
-### Option B — Development install from this repository
+### Option B — Manual Install (Workaround for Windows)
+1. Download the latest `.tgz` from [NPM](https://www.npmjs.com/package/@memtensor/memos-cloud-openclaw-plugin).
+2. Extract it to a local folder (e.g., `C:\Users\YourName\.openclaw\extensions\memos-cloud-openclaw-plugin`).
+3. Configure `~/.openclaw/openclaw.json` (or `%USERPROFILE%\.openclaw\openclaw.json`):
 
-Run these commands from the monorepo repository root. `prepare:openclaw` installs workspace dependencies and builds the shared core into this package; it does not install the plugin or restart OpenClaw.
-
-```powershell
-pnpm prepare:openclaw
-openclaw plugins install .\packages\openclaw
-openclaw gateway restart
+```json
+{
+  "plugins": {
+    "entries": {
+      "memos-cloud-openclaw-plugin": { "enabled": true }
+    },
+    "load": {
+      "paths": [
+        "C:\\Users\\YourName\\.openclaw\\extensions\\memos-cloud-openclaw-plugin"
+      ]
+    }
+  }
+}
 ```
+*Note: The extracted folder usually contains a `package` subfolder. Point to the folder containing `package.json`.*
 
-This installs a copy under OpenClaw's extensions directory and does not require a `plugins.load` entry. After changing the plugin source or `packages/core`, rerun preparation and reinstall the directory, then restart the gateway.
+Restart the gateway after config changes.
 
 ## Environment Variables
 The plugin resolves runtime config in this order: **plugin config → env files**. Due to strict security sandboxing, it **does not** read credentials from process environment variables.
@@ -152,18 +164,15 @@ In `plugins.entries.memos-cloud-openclaw-plugin.config`:
 ```
 
 ## How it Works
-
-### 1) Recall (`before_prompt_build`; falls back to `before_agent_start` on older OpenClaw hosts)
-
-- Builds a `/search/memory` request using `user_id`, `query` (= prompt + optional prefix), and optional filters.
-- Default **global recall**: when `recallGlobal=true`, it does **not** pass `conversation_id`.
-- Optional second-pass filtering: if `recallFilterEnabled=true`, candidates are sent to your configured model and only returned `keep` items are injected.
-- Injects a stable MemOS recall protocol via `appendSystemContext`, while the retrieved `<memories>` block remains in `prependContext`.
-
-### 2) Add (`agent_end`)
-
-- 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`.
+- **Recall** (`before_prompt_build`; falls back to `before_agent_start` on older OpenClaw hosts)
+  - Builds a `/search/memory` request using `user_id`, `query` (= prompt + optional prefix), and optional filters.
+  - Default **global recall**: when `recallGlobal=true`, it does **not** pass `conversation_id`.
+  - Optional second-pass filtering: if `recallFilterEnabled=true`, candidates are sent to your configured model and only returned `keep` items are injected.
+  - Injects a stable MemOS recall protocol via `appendSystemContext`, while the retrieved `<memories>` block remains in `prependContext`.
+
+- **Add** (`agent_end`)
+  - 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):

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.21-beta.0",
+  "version": "0.1.22",
   "kind": "lifecycle",
   "main": "./index.js",
   "activation": {

package/index.js

@@ -23,7 +23,6 @@ import {
   isGatewayRuntimeStartup,
   waitForGatewayReady,
 } from "./lib/config-ui-server.js";
-import { buildMemosAddRequest, buildMemosSearchRequest } from "./lib/memos-core/index.js";
 let lastCaptureTime = 0;
 // ponytail: in-process cache; replace with server idempotency for cross-restart or multi-instance guarantees.
 const recentCaptureKeys = new Set();
@@ -171,20 +170,16 @@ export function buildSearchPayload(cfg, prompt, ctx) {
     payload.filter = { user: userFilter };
   }
 
-  return buildMemosSearchRequest({
-    userId: payload.user_id,
-    query: payload.query,
-    ...(payload.conversation_id === undefined ? {} : { conversationId: payload.conversation_id }),
-    source: payload.source,
-    memoryLimitNumber: cfg.memoryLimitNumber,
-    includePreference: cfg.includePreference,
-    preferenceLimitNumber: cfg.preferenceLimitNumber,
-    includeToolMemory: cfg.includeToolMemory,
-    toolMemoryLimitNumber: cfg.toolMemoryLimitNumber,
-    relativity: cfg.relativity,
-    ...(payload.filter === undefined ? {} : { filter: payload.filter }),
-    ...(cfg.knowledgebaseIds?.length ? { knowledgebaseIds: cfg.knowledgebaseIds } : {}),
-  });
+  if (cfg.knowledgebaseIds?.length) payload.knowledgebase_ids = cfg.knowledgebaseIds;
+
+  payload.memory_limit_number = cfg.memoryLimitNumber;
+  payload.include_preference = cfg.includePreference;
+  payload.preference_limit_number = cfg.preferenceLimitNumber;
+  payload.include_tool_memory = cfg.includeToolMemory;
+  payload.tool_memory_limit_number = cfg.toolMemoryLimitNumber;
+  payload.relativity = cfg.relativity;
+
+  return payload;
 }
 
 export function buildAddMessagePayload(cfg, messages, ctx) {
@@ -208,19 +203,11 @@ export function buildAddMessagePayload(cfg, messages, ctx) {
   };
   if (Object.keys(info).length > 0) payload.info = info;
 
-  return buildMemosAddRequest({
-    userId: payload.user_id,
-    conversationId: payload.conversation_id,
-    messages: payload.messages,
-    source: payload.source,
-    asyncMode: cfg.asyncMode,
-    allowPublic: cfg.allowPublic,
-    ...(payload.tags === undefined ? {} : { tags: payload.tags }),
-    ...(payload.info === undefined ? {} : { info: payload.info }),
-    ...(payload.agent_id === undefined ? {} : { agentId: payload.agent_id }),
-    ...(payload.app_id === undefined ? {} : { appId: payload.app_id }),
-    ...(cfg.allowKnowledgebaseIds?.length ? { allowKnowledgebaseIds: cfg.allowKnowledgebaseIds } : {}),
-  });
+  payload.allow_public = cfg.allowPublic;
+  if (cfg.allowKnowledgebaseIds?.length) payload.allow_knowledgebase_ids = cfg.allowKnowledgebaseIds;
+  payload.async_mode = cfg.asyncMode;
+
+  return payload;
 }
 
 function convertAssistantMessage(msg, cfg) {