@foxlight-foundation/foxmemory-plugin-v2 1.0.0

package/openclaw.plugin.json

@@ -0,0 +1,184 @@
+{
+  "id": "foxmemory-plugin-v2",
+  "kind": "memory",
+  "uiHints": {
+    "mode": {
+      "label": "Mode",
+      "help": "\"platform\" for Mem0 cloud, \"open-source\" for self-hosted"
+    },
+    "apiKey": {
+      "label": "Mem0 API Key",
+      "sensitive": true,
+      "placeholder": "m0-...",
+      "help": "API key from app.mem0.ai (or use ${MEM0_API_KEY}). Only needed for platform mode without baseUrl."
+    },
+    "userId": {
+      "label": "Default User ID",
+      "placeholder": "default",
+      "help": "User ID for scoping memories"
+    },
+    "orgId": {
+      "label": "Organization ID",
+      "placeholder": "org-...",
+      "advanced": true
+    },
+    "projectId": {
+      "label": "Project ID",
+      "placeholder": "proj-...",
+      "advanced": true
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "help": "Automatically store conversation context after each agent turn"
+    },
+    "autoRecall": {
+      "label": "Auto-Recall",
+      "help": "Automatically inject relevant memories before each agent turn"
+    },
+    "customInstructions": {
+      "label": "Custom Instructions",
+      "placeholder": "Only store user preferences and important facts...",
+      "help": "Natural language rules for what Mem0 should store or exclude (platform mode)"
+    },
+    "customCategories": {
+      "label": "Custom Categories",
+      "advanced": true,
+      "help": "Map of category names to descriptions for memory tagging (platform mode only). Sensible defaults are built in."
+    },
+    "customPrompt": {
+      "label": "Custom Prompt (Open-Source)",
+      "advanced": true,
+      "help": "Custom prompt for open-source mode memory extraction."
+    },
+    "enableGraph": {
+      "label": "Enable Graph Memory",
+      "help": "Enable Mem0 graph memory for entity relationships (platform mode only)"
+    },
+    "searchThreshold": {
+      "label": "Search Threshold",
+      "placeholder": "0.5",
+      "help": "Minimum similarity score for search results (0-1). Default: 0.5"
+    },
+    "topK": {
+      "label": "Top K Results",
+      "placeholder": "5",
+      "help": "Maximum number of memories to retrieve"
+    },
+    "oss": {
+      "label": "Open-Source Configuration",
+      "advanced": true,
+      "help": "Optional. Configure custom embedder, vector store, LLM, or history DB for open-source mode. Has sensible defaults \u2014 only override what you need."
+    },
+    "baseUrl": {
+      "label": "FoxMemory Base URL",
+      "placeholder": "http://your-foxmemory-host:8082",
+      "help": "If set, plugin uses foxmemory HTTP v2 endpoints instead of Mem0 SDK providers."
+    },
+    "requestTimeoutMs": {
+      "label": "Request Timeout (ms)",
+      "placeholder": "10000",
+      "advanced": true
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "mode": {
+        "type": "string",
+        "enum": [
+          "platform",
+          "open-source",
+          "oss"
+        ]
+      },
+      "apiKey": {
+        "type": "string"
+      },
+      "userId": {
+        "type": "string"
+      },
+      "orgId": {
+        "type": "string"
+      },
+      "projectId": {
+        "type": "string"
+      },
+      "autoCapture": {
+        "type": "boolean"
+      },
+      "autoRecall": {
+        "type": "boolean"
+      },
+      "customInstructions": {
+        "type": "string"
+      },
+      "customCategories": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        }
+      },
+      "customPrompt": {
+        "type": "string"
+      },
+      "enableGraph": {
+        "type": "boolean"
+      },
+      "searchThreshold": {
+        "type": "number"
+      },
+      "topK": {
+        "type": "number"
+      },
+      "oss": {
+        "type": "object",
+        "properties": {
+          "embedder": {
+            "type": "object",
+            "properties": {
+              "provider": {
+                "type": "string"
+              },
+              "config": {
+                "type": "object"
+              }
+            }
+          },
+          "vectorStore": {
+            "type": "object",
+            "properties": {
+              "provider": {
+                "type": "string"
+              },
+              "config": {
+                "type": "object"
+              }
+            }
+          },
+          "llm": {
+            "type": "object",
+            "properties": {
+              "provider": {
+                "type": "string"
+              },
+              "config": {
+                "type": "object"
+              }
+            }
+          },
+          "historyDbPath": {
+            "type": "string"
+          }
+        }
+      },
+      "baseUrl": {
+        "type": "string"
+      },
+      "requestTimeoutMs": {
+        "type": "number"
+      }
+    },
+    "required": []
+  }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@foxlight-foundation/foxmemory-plugin-v2",
+  "version": "1.0.0",
+  "description": "OpenClaw memory plugin backed by the FoxMemory HTTP v2 API (Qdrant + Neo4j)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "yarn build"
+  },
+  "keywords": [
+    "openclaw",
+    "memory",
+    "mem0",
+    "foxmemory",
+    "qdrant",
+    "neo4j"
+  ],
+  "author": "Foxlight contributors",
+  "license": "MIT",
+  "type": "commonjs",
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.48"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "lib": ["ES2020", "DOM"],
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": false,
+    "noImplicitAny": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "typeRoots": ["./typings", "./node_modules/@types"]
+  },
+  "include": ["index.ts", "typings/**/*.d.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/typings/external.d.ts

@@ -0,0 +1,20 @@
+// Stub type declarations for runtime-provided / optional dependencies.
+// These modules are either supplied by the OpenClaw host at runtime or
+// loaded lazily; they are not installed as build-time dependencies.
+
+declare module "openclaw/plugin-sdk" {
+  export interface OpenClawPluginApi {
+    [key: string]: any;
+  }
+}
+
+declare module "mem0ai" {
+  const MemoryClient: any;
+  export default MemoryClient;
+}
+
+declare module "mem0ai/oss" {
+  const MemoryClient: any;
+  export const Memory: any;
+  export default MemoryClient;
+}