openclaw-memory-decay 0.1.7 → 0.1.9

package/README.md

@@ -67,7 +67,7 @@ python3 -m venv ~/.openclaw/venvs/memory-decay
 openclaw plugins install openclaw-memory-decay
 
 # 3. (Optional but recommended) Restrict auto-load to trusted plugins only
-openclaw config set plugins.allow '["memory-decay"]'
+openclaw config set plugins.allow '["openclaw-memory-decay"]'
 
 # 4. Restart the gateway
 openclaw gateway restart
@@ -86,41 +86,52 @@ openclaw gateway restart
 If you previously installed this plugin from a local checkout via `openclaw plugins install -l .`, migrate to the npm package. Local/path-based installs are now deprecated in favor of the published npm package.
 
 ```bash
-# 1. Install from npm instead
+# 1. Remove the old pre-0.1.8 plugin install if it exists
+openclaw plugins uninstall memory-decay
+
+# 2. Install from npm instead
 openclaw plugins install openclaw-memory-decay
 
-# 2. Restart gateway
+# 3. Restart gateway
 openclaw gateway restart
 
-# 3. Verify
-openclaw plugins list | grep memory-decay  # should show: memory-decay | loaded
+# 4. Verify
+openclaw plugins list | grep openclaw-memory-decay  # should show: openclaw-memory-decay | loaded
 curl -s http://127.0.0.1:8100/health       # should show: {"status":"ok","current_tick":0}
 ```
 
+If the old install is already gone, `openclaw plugins uninstall memory-decay` will simply report that nothing was removed.
+
 If auto-detection does not recover your backend path after migration, set the interpreter explicitly:
 
 ```bash
-openclaw config set plugins.entries.memory-decay.config.pythonPath "~/.openclaw/venvs/memory-decay/bin/python"
+openclaw config set plugins.entries.openclaw-memory-decay.config.pythonPath "~/.openclaw/venvs/memory-decay/bin/python"
 openclaw gateway restart
 ```
 
+If you are upgrading from an older release, note the plugin id changed from `memory-decay` to `openclaw-memory-decay` in `0.1.8`.
+
+- New installs should use `plugins.entries.openclaw-memory-decay`.
+- Older configs under `plugins.entries.memory-decay.config` are still read as a compatibility fallback.
+- For a clean config, migrate to the new key when convenient.
+
 **Your memories are safe.** The SQLite database (`memories.db`) is not affected by plugin reinstallation or migration to npm install.
 
 To update in the future:
 ```bash
-openclaw plugins update memory-decay
+openclaw plugins update openclaw-memory-decay
 openclaw gateway restart
 ```
 
 ## Configuration
 
-Add to `~/.openclaw/openclaw.json` under `plugins.entries.memory-decay.config`:
+Add to `~/.openclaw/openclaw.json` under `plugins.entries.openclaw-memory-decay.config`:
 
 ```json
 {
   "plugins": {
     "entries": {
-      "memory-decay": {
+      "openclaw-memory-decay": {
         "enabled": true,
         "config": {
           "dbPath": "~/.openclaw/memory-decay-data/memories.db",
@@ -136,8 +147,8 @@ Add to `~/.openclaw/openclaw.json` under `plugins.entries.memory-decay.config`:
 | Option | Default | Description |
 |--------|---------|-------------|
 | `serverPort` | `8100` | Port for the memory-decay HTTP server |
-| `memoryDecayPath` | (auto) | Path to memory-decay-core. Auto-detected from the install-time Python environment if not set |
-| `pythonPath` | `python3` | Path to Python interpreter. Set this explicitly if you use a custom venv path instead of `~/.openclaw/venvs/memory-decay` |
+| `memoryDecayPath` | (auto) | Path to memory-decay-core. Auto-detected at runtime from the documented default venv or from explicit config |
+| `pythonPath` | `python3` | Path to Python interpreter. Set this explicitly if you do not use `~/.openclaw/venvs/memory-decay` |
 | `dbPath` | `~/.openclaw/memory-decay-data/memories.db` | SQLite database location |
 | `autoSave` | `true` | Auto-save every conversation turn at low importance. Set `false` to let the agent decide what to save |
 | `embeddingProvider` | `local` | Embedding provider: `local`, `openai`, or `gemini` |
@@ -243,7 +254,7 @@ The plugin registers these tools:
 This warning appears when `plugins.allow` is not set. While the plugin still loads (since it is explicitly configured in `plugins.entries`), it is good practice to restrict auto-load to trusted plugins only:
 
 ```bash
-openclaw config set plugins.allow '["memory-decay"]'
+openclaw config set plugins.allow '["openclaw-memory-decay"]'
 openclaw gateway restart
 ```
 
@@ -263,12 +274,32 @@ openclaw plugins install openclaw-memory-decay
 curl http://127.0.0.1:8100/health
 ```
 
-If the import check fails, install the backend into a virtualenv and either reactivate that venv before reinstalling the plugin or set `pythonPath` explicitly:
+If the import check fails, install the backend into the documented default venv path or set `pythonPath` explicitly:
 ```bash
 python3 -m venv ~/.openclaw/venvs/memory-decay
 ~/.openclaw/venvs/memory-decay/bin/pip install memory-decay
 ```
 
+If `memory-decay` is only installed in your system Python or in some other venv, the plugin may still fail to auto-detect it. In that case, point the plugin at the exact Python you want it to use:
+
+```bash
+openclaw config set plugins.entries.openclaw-memory-decay.config.pythonPath "/absolute/path/to/python"
+openclaw gateway restart
+```
+
+Sanity check the exact interpreter before restarting:
+
+```bash
+/absolute/path/to/python -c "import memory_decay.server; print('ok')"
+```
+
+If you use a different venv path, configure it directly:
+
+```bash
+openclaw config set plugins.entries.openclaw-memory-decay.config.pythonPath "/absolute/path/to/venv/bin/python"
+openclaw gateway restart
+```
+
 ### `error: externally-managed-environment`
 
 Your system Python is PEP 668 managed. Install `memory-decay` into a virtualenv instead of the system interpreter:
@@ -304,7 +335,7 @@ openclaw gateway restart
 
 # 4. Verify plugin is loaded
 openclaw plugins list
-# Look for: memory-decay | loaded
+# Look for: openclaw-memory-decay | loaded
 
 # 5. Check server health
 curl -s http://127.0.0.1:8100/health

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
-  "id": "memory-decay",
+  "id": "openclaw-memory-decay",
   "name": "Memory Decay",
   "description": "Human-like memory with decay and reinforcement for OpenClaw agents",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "configSchema": {
     "type": "object",
     "additionalProperties": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-memory-decay",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "OpenClaw memory plugin backed by memory-decay engine",
   "main": "./src/index.js",

package/scripts/detect-python-lib.mjs

@@ -3,6 +3,10 @@ import { existsSync as nodeExistsSync, mkdtempSync, readFileSync, rmSync } from
 import { homedir as nodeHomedir, tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 
+const PYTHON_COMMAND_CANDIDATES = process.platform === "win32"
+  ? ["python"]
+  : ["python3", "python", "python3.13", "python3.12", "python3.11", "python3.10"];
+
 function resolvePythonPath(command, { execFileSync = nodeExecFileSync, isWin = process.platform === "win32" } = {}) {
   if (isAbsolute(command)) {
     return command;
@@ -43,7 +47,7 @@ export function buildPythonCandidates({
     pathCandidates.push(join(root, isWin ? ".venv/Scripts/python.exe" : ".venv/bin/python"));
   }
 
-  const commandCandidates = isWin ? ["python"] : ["python3", "python"];
+  const commandCandidates = isWin ? ["python"] : PYTHON_COMMAND_CANDIDATES;
   return [...new Set([
     ...pathCandidates.filter((candidate) => existsSync(candidate)),
     ...commandCandidates,

package/src/index.ts

@@ -1,6 +1,7 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { MemoryDecayClient } from "./client.js";
+import { loadLegacyPluginConfig } from "./legacy-config.js";
 import { MemoryDecayService, type ServiceConfig } from "./service.js";
 import { shouldMigrate, migrateMarkdownMemories } from "./migrator.js";
 import { detectPythonEnv, mergePythonEnv } from "./python-env.js";
@@ -39,14 +40,14 @@ Your memories naturally decay over time. Frequently recalled memories grow stron
 const MIN_MESSAGE_LENGTH = 20;
 
 const memoryDecayPlugin = {
-  id: "memory-decay",
+  id: "openclaw-memory-decay",
   name: "Memory Decay",
   description: "Human-like memory with decay and reinforcement",
   kind: "memory" as const,
   configSchema: emptyPluginConfigSchema(),
 
   register(api: OpenClawPluginApi) {
-    const cfg = api.pluginConfig ?? {};
+    const cfg = loadLegacyPluginConfig((api.pluginConfig ?? {}) as Record<string, unknown>);
     const port = (cfg.serverPort as number) ?? 8100;
     const autoSave = cfg.autoSave !== false; // default true
 

package/src/legacy-config.ts

@@ -0,0 +1,35 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+
+export type PluginConfigLike = Record<string, unknown>;
+
+function resolveOpenClawConfigPath(env: NodeJS.ProcessEnv = process.env): string {
+  return resolve(env.OPENCLAW_HOME || homedir(), ".openclaw", "openclaw.json");
+}
+
+export function loadLegacyPluginConfig(
+  currentConfig: PluginConfigLike,
+  {
+    env = process.env,
+    configPath = resolveOpenClawConfigPath(env),
+  }: { env?: NodeJS.ProcessEnv; configPath?: string } = {},
+): PluginConfigLike {
+  if (Object.keys(currentConfig).length > 0) {
+    return currentConfig;
+  }
+
+  if (!existsSync(configPath)) {
+    return currentConfig;
+  }
+
+  try {
+    const root = JSON.parse(readFileSync(configPath, "utf8"));
+    const legacyConfig = root?.plugins?.entries?.["memory-decay"]?.config;
+    return legacyConfig && typeof legacyConfig === "object"
+      ? { ...legacyConfig }
+      : currentConfig;
+  } catch {
+    return currentConfig;
+  }
+}

package/src/python-env.ts

@@ -20,6 +20,10 @@ interface DetectPythonEnvOptions {
   removeTempDir?: (path: string) => void;
 }
 
+const PYTHON_COMMAND_CANDIDATES = process.platform === "win32"
+  ? ["python"]
+  : ["python3", "python", "python3.13", "python3.12", "python3.11", "python3.10"];
+
 export function mergePythonEnv(
   configured: PythonEnvLike,
   detected: PythonEnvLike = {},
@@ -73,7 +77,7 @@ export function buildPythonCandidates({
       join(root, isWin ? ".venv/Scripts/python.exe" : ".venv/bin/python")),
   ].filter((candidate): candidate is string => typeof candidate === "string" && candidate.length > 0 && existsSync(candidate));
 
-  const commandCandidates = isWin ? ["python"] : ["python3", "python"];
+  const commandCandidates = isWin ? ["python"] : PYTHON_COMMAND_CANDIDATES;
   return [...new Set([...pathCandidates, ...commandCandidates])];
 }