@xmemo/openclaw-memory 1.0.0

package/npm-shrinkwrap.json

@@ -0,0 +1,21 @@
+{
+  "name": "@xmemo/openclaw-memory",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@xmemo/openclaw-memory",
+      "version": "1.0.0",
+      "dependencies": {
+        "typebox": "1.1.39"
+      }
+    },
+    "node_modules/typebox": {
+      "version": "1.1.39",
+      "resolved": "https://registry.npmjs.org/typebox/-/typebox-1.1.39.tgz",
+      "integrity": "sha512-vj0afVtOfLQvv0GR0VxVagYxsXN64btL7Z9XoaG0ZggH3mruMMkOO6hXdgMsjCY3shZgEvooAWVeznQVs5c43w==",
+      "license": "MIT"
+    }
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,203 @@
+{
+  "id": "xmemo-memory",
+  "name": "XMemo for OpenClaw",
+  "description": "XMemo identity-aware memory control plane for OpenClaw. Brings user-owned, auditable, cross-agent memory into OpenClaw.",
+  "kind": "memory",
+  "activation": {
+    "onStartup": false,
+    "onCommands": ["memory"]
+  },
+  "contracts": {
+    "tools": [
+      "memory_search",
+      "memory_get",
+      "memory_store",
+      "memory_forget",
+      "xmemo_memory_list",
+      "xmemo_memory_update",
+      "xmemo_todo_create",
+      "xmemo_todo_list",
+      "xmemo_todo_complete",
+      "xmemo_record_event",
+      "xmemo_restart_snapshot_save",
+      "xmemo_restart_snapshot_restore",
+      "xmemo_ledger_monthly_summary",
+      "xmemo_audit_events",
+      "xmemo_audit_consolidation"
+    ]
+  },
+  "uiHints": {
+    "baseUrl": {
+      "label": "XMemo Service URL",
+      "placeholder": "https://xmemo.dev",
+      "help": "Base URL of the XMemo instance. Use a private/self-hosted URL if not using the hosted service.",
+      "advanced": true
+    },
+    "apiKey": {
+      "label": "XMemo API Key",
+      "placeholder": "xmemo_...",
+      "help": "Create a scoped API key in XMemo Memory Console -> API Keys -> Create API key. Prefer setting XMEMO_KEY instead of storing the key here.",
+      "sensitive": true
+    },
+    "token": {
+      "label": "XMemo Token (deprecated)",
+      "placeholder": "xmemo_...",
+      "help": "Deprecated alias for apiKey. Prefer apiKey or the XMEMO_KEY environment variable.",
+      "sensitive": true,
+      "advanced": true
+    },
+    "authMode": {
+      "label": "Auth Mode",
+      "placeholder": "api-key",
+      "help": "How to send the credential: api-key (X-API-Key header), bearer (Authorization: Bearer), or both.",
+      "advanced": true
+    },
+    "bucket": {
+      "label": "Default Bucket",
+      "placeholder": "openclaw",
+      "help": "Default bucket for memories created by OpenClaw."
+    },
+    "scope": {
+      "label": "Default Scope",
+      "placeholder": "openclaw",
+      "help": "Optional scope for isolating this workspace/agent.",
+      "advanced": true
+    },
+    "teamId": {
+      "label": "Team ID",
+      "placeholder": "",
+      "help": "Optional team/organization id for enterprise XMemo deployments.",
+      "advanced": true
+    },
+    "agentId": {
+      "label": "Agent ID",
+      "placeholder": "openclaw",
+      "help": "Non-secret agent identifier sent to XMemo for attribution.",
+      "advanced": true
+    },
+    "autoCapture": {
+      "label": "Auto Capture",
+      "help": "Automatically persist high-signal decisions and fixes to XMemo."
+    },
+    "captureMaxChars": {
+      "label": "Capture Max Chars",
+      "help": "Maximum message length eligible for auto-capture.",
+      "advanced": true,
+      "placeholder": "500"
+    },
+    "customTriggers": {
+      "label": "Custom Auto-Capture Triggers",
+      "help": "Additional words or phrases that trigger auto-capture (case-insensitive).",
+      "advanced": true
+    },
+    "recallMaxChars": {
+      "label": "Recall Query Max Chars",
+      "help": "Maximum prompt/query length sent to XMemo for recall.",
+      "advanced": true,
+      "placeholder": "1000"
+    },
+    "recallMaxItems": {
+      "label": "Recall Max Items",
+      "help": "Maximum number of memories returned by XMemo recall.",
+      "advanced": true,
+      "placeholder": "8"
+    },
+    "recallMaxTokens": {
+      "label": "Recall Max Tokens",
+      "help": "Maximum token budget for the recalled context package.",
+      "advanced": true,
+      "placeholder": "1500"
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "baseUrl": {
+        "type": "string",
+        "format": "uri"
+      },
+      "apiKey": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "source": { "type": "string", "enum": ["env"] },
+              "provider": { "type": "string" },
+              "id": { "type": "string" }
+            },
+            "required": ["source", "provider", "id"]
+          }
+        ]
+      },
+      "token": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "source": { "type": "string", "enum": ["env"] },
+              "provider": { "type": "string" },
+              "id": { "type": "string" }
+            },
+            "required": ["source", "provider", "id"]
+          }
+        ]
+      },
+      "authMode": {
+        "type": "string",
+        "enum": ["api-key", "bearer", "both"],
+        "default": "api-key"
+      },
+      "bucket": {
+        "type": "string",
+        "default": "openclaw"
+      },
+      "scope": {
+        "type": ["string", "null"]
+      },
+      "teamId": {
+        "type": ["string", "null"]
+      },
+      "agentId": {
+        "type": "string",
+        "default": "openclaw"
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "default": false
+      },
+      "captureMaxChars": {
+        "type": "number",
+        "minimum": 100,
+        "maximum": 10000,
+        "default": 500
+      },
+      "customTriggers": {
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "recallMaxChars": {
+        "type": "number",
+        "minimum": 100,
+        "maximum": 10000,
+        "default": 1000
+      },
+      "recallMaxItems": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 50,
+        "default": 8
+      },
+      "recallMaxTokens": {
+        "type": "integer",
+        "minimum": 100,
+        "maximum": 8000,
+        "default": 1500
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@xmemo/openclaw-memory",
+  "version": "1.0.0",
+  "description": "XMemo for OpenClaw — bring XMemo's identity-aware memory control plane into OpenClaw as the active memory backend.",
+  "keywords": [
+    "xmemo",
+    "memory-os",
+    "openclaw",
+    "memory",
+    "agent-memory",
+    "identity-aware-memory",
+    "memory-control-plane"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yonro/xmemo-openclaw-memory"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist/**",
+    "assets/**",
+    "openclaw.plugin.json",
+    "README.md",
+    "package.json",
+    "npm-shrinkwrap.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint .",
+    "prepack": "pnpm build"
+  },
+  "dependencies": {
+    "typebox": "1.1.39"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.1",
+    "openclaw": "2026.6.8",
+    "oxlint": "0.16.8",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.6.8"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "install": {
+      "npmSpec": "@xmemo/openclaw-memory",
+      "clawhubSpec": "clawhub:@xmemo/openclaw-memory",
+      "defaultChoice": "clawhub",
+      "minHostVersion": ">=2026.6.8"
+    },
+    "compat": {
+      "pluginApi": ">=2026.6.8"
+    },
+    "build": {
+      "openclawVersion": "2026.6.8"
+    },
+    "release": {
+      "bundleRuntimeDependencies": false,
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  },
+  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
+}