openclaw-memory-decay 0.1.8 → 0.1.9

package/README.md

@@ -86,17 +86,22 @@ 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
+# 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
@@ -104,6 +109,12 @@ openclaw config set plugins.entries.openclaw-memory-decay.config.pythonPath "~/.
 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:
@@ -136,8 +147,8 @@ Add to `~/.openclaw/openclaw.json` under `plugins.entries.openclaw-memory-decay.
 | 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` |
@@ -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:

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-memory-decay",
-  "version": "0.1.8",
+  "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/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])];
 }