@matrixorigin/thememoria 0.4.0 → 0.4.1

package/openclaw.plugin.json

@@ -1,13 +1,13 @@
 {
-  "id": "memory-memoria",
-  "name": "Memory (Memoria)",
+  "id": "thememoria",
+  "name": "Memoria",
   "description": "Memoria-backed long-term memory plugin for OpenClaw powered by the Rust memoria CLI and API.",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "kind": "memory",
   "uiHints": {
     "backend": {
       "label": "Backend Mode",
-      "help": "embedded runs the Rust memoria CLI locally against MatrixOne; http connects to an existing Memoria API.",
+      "help": "embedded runs the Rust memoria CLI locally against MatrixOne; api connects directly to the Memoria REST API over HTTP.",
       "placeholder": "embedded"
     },
     "dbUrl": {
@@ -17,14 +17,14 @@
     },
     "apiUrl": {
       "label": "Memoria API URL",
-      "help": "Only used when backend=http.",
+      "help": "Only used when backend=api.",
       "placeholder": "http://127.0.0.1:8100"
     },
     "apiKey": {
       "label": "Memoria API Token",
-      "help": "Bearer token for backend=http.",
+      "help": "Bearer token for backend=api.",
       "sensitive": true,
-      "placeholder": "mem-..."
+      "placeholder": "sk-..."
     },
     "memoriaExecutable": {
       "label": "Memoria Executable",
@@ -151,7 +151,7 @@
     "properties": {
       "backend": {
         "type": "string",
-        "enum": ["embedded", "http"]
+        "enum": ["embedded", "api"]
       },
       "dbUrl": {
         "type": "string"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matrixorigin/thememoria",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "OpenClaw memory plugin that uses the Rust Memoria CLI/API for embedded and remote backends.",
   "repository": {
     "type": "git",
@@ -33,6 +33,10 @@
   "engines": {
     "node": ">=22"
   },
+  "scripts": {
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"
   },
@@ -41,6 +45,11 @@
       "optional": true
     }
   },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
   "openclaw": {
     "extensions": [
       "./openclaw/index.ts"

package/scripts/connect_openclaw_memoria.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
+import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 
 function fail(message) {
-  console.error(`[memory-memoria] ${message}`);
+  console.error(`[thememoria] ${message}`);
   process.exit(1);
 }
 
@@ -23,13 +24,40 @@ function normalizeUrl(value) {
   return value.trim().replace(/\/+$/, "");
 }
 
+function resolveExecutable(command) {
+  if (!command) {
+    return null;
+  }
+  if (command.includes("/") || command.includes("\\")) {
+    return fs.existsSync(command) ? path.resolve(command) : null;
+  }
+  const result = spawnSync("/usr/bin/env", ["which", command], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"],
+  });
+  if (result.status !== 0 || typeof result.stdout !== "string") {
+    return null;
+  }
+  const resolved = result.stdout.trim().split(/\r?\n/).find(Boolean);
+  return resolved ? path.resolve(resolved) : null;
+}
+
+function binaryLacksLocalEmbeddingSupport(executablePath) {
+  try {
+    const content = fs.readFileSync(executablePath);
+    return content.includes(Buffer.from("compiled without local-embedding feature", "utf8"));
+  } catch {
+    return false;
+  }
+}
+
 const modeRaw = readArg("--mode", "cloud").trim().toLowerCase();
 if (modeRaw !== "cloud" && modeRaw !== "local") {
   fail("mode must be one of: cloud, local");
 }
 const mode = modeRaw;
 
-const pluginId = readArg("--plugin-id", "memory-memoria").trim() || "memory-memoria";
+const pluginId = readArg("--plugin-id", "thememoria").trim() || "thememoria";
 const configFile = path.resolve(
   readArg(
     "--config-file",
@@ -82,7 +110,7 @@ if (mode === "cloud") {
   if (!apiKey) {
     fail("--api-key required when mode=cloud");
   }
-  pluginConfig.backend = "http";
+  pluginConfig.backend = "api";
   pluginConfig.apiUrl = normalizeUrl(apiUrl);
   pluginConfig.apiKey = apiKey;
   delete pluginConfig.dbUrl;
@@ -106,6 +134,24 @@ if (mode === "cloud") {
     fail("--embedding-api-key required for mode=local when embedding-provider is not 'local'");
   }
 
+  const effectiveMemoriaExecutable =
+    memoriaExecutable ||
+    (typeof pluginConfig.memoriaExecutable === "string" ? pluginConfig.memoriaExecutable.trim() : "") ||
+    "memoria";
+  if (embeddingProvider === "local") {
+    const resolvedExecutable = resolveExecutable(effectiveMemoriaExecutable);
+    if (!resolvedExecutable) {
+      fail(
+        `embedding-provider=local requires a usable memoria executable, but '${effectiveMemoriaExecutable}' could not be resolved. Pass --memoria-executable <path> or install memoria first.`,
+      );
+    }
+    if (binaryLacksLocalEmbeddingSupport(resolvedExecutable)) {
+      fail(
+        `embedding-provider=local requires a memoria binary built with local-embedding support. Resolved '${resolvedExecutable}', but this binary was built without that feature. Use a remote embedding provider or install/rebuild a local-embedding-enabled memoria binary.`,
+      );
+    }
+  }
+
   pluginConfig.backend = "embedded";
   pluginConfig.dbUrl = dbUrl;
   pluginConfig.embeddingProvider = embeddingProvider;
@@ -153,11 +199,11 @@ console.log(
       pluginId,
       backend: pluginConfig.backend,
       apiUrl:
-        pluginConfig.backend === "http" && typeof pluginConfig.apiUrl === "string"
+        pluginConfig.backend === "api" && typeof pluginConfig.apiUrl === "string"
           ? pluginConfig.apiUrl
           : undefined,
       apiKeySet:
-        pluginConfig.backend === "http" &&
+        pluginConfig.backend === "api" &&
         typeof pluginConfig.apiKey === "string" &&
         pluginConfig.apiKey.length > 0,
       dbUrl: typeof pluginConfig.dbUrl === "string" ? pluginConfig.dbUrl : undefined,

package/scripts/install-openclaw-memoria.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-PLUGIN_ID="memory-memoria"
+PLUGIN_ID="thememoria"
 DEFAULT_REPO_URL="https://github.com/matrixorigin/Memoria.git"
 DEFAULT_REPO_REF="main"
 DEFAULT_MEMORIA_VERSION="v0.1.0"
@@ -39,14 +39,20 @@ MEMORIA_TOOL_NAMES=(
 )
 
 log() {
-  printf '[memory-memoria] %s\n' "$*"
+  printf '[thememoria] %s\n' "$*"
 }
 
 fail() {
-  printf '[memory-memoria] error: %s\n' "$*" >&2
+  printf '[thememoria] error: %s\n' "$*" >&2
   exit 1
 }
 
+binary_lacks_local_embedding_support() {
+  local bin_path="$1"
+  [[ -f "${bin_path}" ]] || return 1
+  LC_ALL=C grep -a -q 'compiled without local-embedding feature' "${bin_path}"
+}
+
 need_cmd() {
   command -v "$1" >/dev/null 2>&1 || fail "Missing required command: $1"
 }
@@ -508,7 +514,10 @@ if [[ "${MEMORIA_EMBEDDING_PROVIDER}" != "local" && -z "${MEMORIA_EMBEDDING_DIM}
   log "Auto-selected embedding dimension ${MEMORIA_EMBEDDING_DIM} for ${MEMORIA_EMBEDDING_MODEL}"
 fi
 if [[ "${MEMORIA_EMBEDDING_PROVIDER}" == "local" ]]; then
-  log "Embedding provider is local. Make sure your memoria binary was built with local-embedding support."
+  if binary_lacks_local_embedding_support "${MEMORIA_EXECUTABLE_VALUE}"; then
+    fail "MEMORIA_EMBEDDING_PROVIDER=local requires a memoria binary built with local-embedding support. Resolved ${MEMORIA_EXECUTABLE_VALUE}, but that binary was built without the feature. Use a remote embedding provider or install/rebuild a local-embedding-enabled memoria binary."
+  fi
+  log "Embedding provider is local and the selected memoria binary passed the local-embedding capability check."
 fi
 if [[ "${MEMORIA_AUTO_OBSERVE}" == "true" ]]; then
   [[ -n "${MEMORIA_LLM_API_KEY}" ]] || fail "MEMORIA_AUTO_OBSERVE=true requires MEMORIA_LLM_API_KEY"

package/scripts/uninstall-openclaw-memoria.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-PLUGIN_ID="memory-memoria"
+PLUGIN_ID="thememoria"
 DEFAULT_INSTALL_DIR="${HOME}/.local/share/openclaw-plugins/openclaw-memoria"
 
 MEMORIA_TOOL_NAMES=(
@@ -37,11 +37,11 @@ MEMORIA_TOOL_NAMES=(
 )
 
 log() {
-  printf '[memory-memoria] %s\n' "$*"
+  printf '[thememoria] %s\n' "$*"
 }
 
 fail() {
-  printf '[memory-memoria] error: %s\n' "$*" >&2
+  printf '[thememoria] error: %s\n' "$*" >&2
   exit 1
 }
 
@@ -66,9 +66,9 @@ Environment overrides:
   OPENCLAW_HOME        Optional target OpenClaw home.
 
 What gets removed by default:
-  - plugins.entries["memory-memoria"]
-  - plugins.installs["memory-memoria"]
-  - plugins.allow entry for memory-memoria
+  - plugins.entries["thememoria"]
+  - plugins.installs["thememoria"]
+  - plugins.allow entry for thememoria
   - plugins.load.paths entries that point at this plugin
   - tool policy entries for the Memoria tool surface
   - managed companion skills in ~/.openclaw/skills: memoria-memory, memoria-recovery
@@ -357,6 +357,6 @@ Config file: ${CONFIG_FILE}
 
 Recommended follow-up checks:
   cd ~
-  openclaw plugins list --json | rg 'memory-memoria|openclaw-memoria' || true
+  openclaw plugins list --json | rg 'thememoria|openclaw-memoria' || true
   openclaw config get 'plugins.slots.memory'
 EOF

package/scripts/verify_plugin_install.mjs

@@ -78,14 +78,14 @@ if (!fs.existsSync(configFile)) {
 }
 
 const config = JSON.parse(fs.readFileSync(configFile, "utf8"));
-const pluginEntry = config?.plugins?.entries?.["memory-memoria"];
+const pluginEntry = config?.plugins?.entries?.["thememoria"];
 if (!pluginEntry || pluginEntry.enabled !== true) {
-  throw new Error("plugins.entries.memory-memoria is not enabled");
+  throw new Error("plugins.entries.thememoria is not enabled");
 }
 
 const pluginConfig = pluginEntry.config ?? {};
 if (pluginConfig.memoriaExecutable == null) {
-  throw new Error("plugins.entries.memory-memoria.config.memoriaExecutable is missing");
+  throw new Error("plugins.entries.thememoria.config.memoriaExecutable is missing");
 }
 
 const resolvedMemoriaBin = pluginConfig.memoriaExecutable || memoriaBin;