@echomem/echo-memory-cloud-openclaw-plugin 0.2.0 → 0.2.2

package/README.md

@@ -59,8 +59,11 @@ Path resolution order for `memoryDir`:
 Supported runtime `.env` locations:
 
 - `~/.openclaw/.env`
-- `~/.moltbot/.env`
-- `~/.clawdbot/.env`
+
+Legacy one-release migration bridge:
+
+- if `~/.openclaw/.env` is missing, EchoMemory can still read `~/.moltbot/.env` or `~/.clawdbot/.env`
+- new saves and updated setup should go to `~/.openclaw/.env`
 
 Supported environment variables:
 
@@ -132,6 +135,11 @@ Older configs may still include `baseUrl` or `webBaseUrl`. Those keys are deprec
 
 ### Install from a local path
 
+Version note:
+
+- on OpenClaw `2026.3.22+`, avoid bare plugin names during install because plugin source precedence changed
+- use an exact local path, `--link`, or the exact scoped npm package
+
 On Windows, quote the path if your username or folders contain spaces:
 
 ```powershell
@@ -229,6 +237,7 @@ The plugin starts a localhost workspace UI during gateway startup and can auto-o
 
 - first run can automatically trigger `npm install` and `npm run build` under `lib/local-ui`
 - browser auto-open is skipped automatically for SSH, CI, and headless Linux sessions
+- when the gateway restarts, an already-open local UI tab reconnects and refreshes itself instead of spawning a redundant new tab
 - `/echo-memory view` returns the current localhost URL for the local markdown workspace UI and also tries to open the browser
 - natural-language requests can use the `echo_memory_local_ui` tool to get the exact live URL instead of guessing the port
 - the local markdown archive stays fully browsable even when no Echo Cloud API key is configured

package/clawdbot.plugin.json

@@ -2,7 +2,7 @@
   "id": "echo-memory-cloud-openclaw-plugin",
   "name": "Echo Memory Cloud OpenClaw Plugin",
   "description": "Sync OpenClaw local markdown memory files to Echo cloud",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "kind": "lifecycle",
   "main": "./index.js",
   "configSchema": {
@@ -22,7 +22,7 @@
       },
       "memoryDir": {
         "type": "string",
-        "description": "Absolute path to the markdown memory directory. Falls back to ECHOMEM_MEMORY_DIR, then ~/.clawdbot/workspace/memory."
+        "description": "Absolute path to the markdown memory directory. Falls back to ECHOMEM_MEMORY_DIR, then ~/.openclaw/workspace/memory."
       },
       "localOnlyMode": {
         "type": "boolean",

package/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import path from "node:path";
-import { buildConfig, getEnvFileStatus } from "./lib/config.js";
+import { buildConfig, getEnvFileStatus, getOpenClawHome } from "./lib/config.js";
 import { createApiClient } from "./lib/api-client.js";
 import { formatSearchResultsText } from "./lib/echo-memory-search.js";
 import {
@@ -15,7 +15,16 @@ import {
 import { buildOnboardingText } from "./lib/onboarding.js";
 import { createSyncRunner, formatStatusText } from "./lib/sync.js";
 import { readLastSyncState } from "./lib/state.js";
-import { openUrlInDefaultBrowser, startLocalServer, stopLocalServer } from "./lib/local-server.js";
+import {
+  hasRecentLocalUiPresence,
+  openUrlInDefaultBrowser,
+  startLocalServer,
+  stopLocalServer,
+  waitForLocalUiClient,
+} from "./lib/local-server.js";
+
+const LOCAL_UI_RECONNECT_GRACE_MS = 4000;
+const LOCAL_UI_PRESENCE_GRACE_MS = 75000;
 
 function resolveCommandLabel(channel) {
   return channel === "discord" ? "/echomemory" : "/echo-memory";
@@ -47,13 +56,15 @@ export default {
     const cfg = buildConfig(api.pluginConfig);
     const client = createApiClient(cfg);
     const workspaceDir = path.resolve(path.dirname(cfg.memoryDir), "..");
-    const openclawHome = path.resolve(workspaceDir, "..");
-    const fallbackStateDir = path.join(openclawHome, "state", "plugins", "echo-memory-cloud-openclaw-plugin");
+    const openclawHome = getOpenClawHome();
+    const legacyPluginStateDir = path.join(openclawHome, "state", "plugins", "echo-memory-cloud-openclaw-plugin");
+    const stableStateDir = path.join(openclawHome, "state", "echo-memory-cloud-openclaw-plugin");
     const syncRunner = createSyncRunner({
       api,
       cfg,
       client,
-      fallbackStateDir,
+      fallbackStateDir: legacyPluginStateDir,
+      stableStateDir,
     });
     let startupBrowserOpenAttempted = false;
     let backgroundStarted = false;
@@ -75,10 +86,20 @@ export default {
       let openedInBrowser = false;
       let openReason = "not_requested";
       if (openInBrowser) {
-        const openResult = await openUrlInDefaultBrowser(url, {
-          logger: api.logger,
-          force: trigger !== "gateway-start",
-        });
+        const existingPageDetected = trigger === "gateway-start"
+          ? await hasRecentLocalUiPresence(syncRunner, { maxAgeMs: LOCAL_UI_PRESENCE_GRACE_MS })
+          : false;
+        const existingClientDetected = existingPageDetected || (
+          trigger === "gateway-start"
+            ? await waitForLocalUiClient({ timeoutMs: LOCAL_UI_RECONNECT_GRACE_MS })
+            : false
+        );
+        const openResult = existingClientDetected
+          ? { opened: false, reason: existingPageDetected ? "existing_page_detected" : "existing_client_reconnected" }
+          : await openUrlInDefaultBrowser(url, {
+              logger: api.logger,
+              force: trigger !== "gateway-start",
+            });
         openedInBrowser = openResult.opened;
         openReason = openResult.reason;
       }
@@ -130,7 +151,18 @@ export default {
       });
     }
 
-    const envStatus = getEnvFileStatus();
+    const envStatus = getEnvFileStatus();
+    if (envStatus.usingLegacyBridge) {
+      api.logger?.warn?.(
+        `[echo-memory] Legacy env file detected (${envStatus.legacyPaths.join(", ")}). ` +
+        `EchoMemory is using a one-release migration bridge and will write future changes to ${envStatus.primaryPath}.`,
+      );
+    } else if (envStatus.legacyPaths.length > 0) {
+      api.logger?.info?.(
+        `[echo-memory] Legacy env file still present (${envStatus.legacyPaths.join(", ")}). ` +
+        `Current settings should be kept in ${envStatus.primaryPath}.`,
+      );
+    }
     if (!envStatus.found) {
       api.logger?.warn?.(
         `[echo-memory] No .env file found in ${envStatus.searchPaths.join(", ")}. Using plugin config or process env.`,
@@ -142,7 +174,7 @@ export default {
         return;
       }
       backgroundStarted = true;
-      await syncRunner.initialize(stateDir || fallbackStateDir);
+      await syncRunner.initialize(stateDir || legacyPluginStateDir);
 
       try {
         const shouldOpenBrowser = cfg.localUiAutoOpenOnGatewayStart && !startupBrowserOpenAttempted;
@@ -196,7 +228,7 @@ export default {
       if (serviceStartObserved) {
         return;
       }
-      startBackgroundFeatures({ stateDir: fallbackStateDir, trigger: "compat-startup" }).catch((error) => {
+      startBackgroundFeatures({ stateDir: legacyPluginStateDir, trigger: "compat-startup" }).catch((error) => {
         api.logger?.warn?.(`[echo-memory] compatibility startup failed: ${String(error?.message ?? error)}`);
       });
     });

package/lib/config.js

@@ -4,12 +4,25 @@ import { dirname, join } from "node:path";
 
 const DEFAULT_BASE_URL = "https://echo-mem-chrome.vercel.app";
 const DEFAULT_WEB_BASE_URL = "https://www.iditor.com";
-const DEFAULT_CONFIG_PATH = process.env.OPENCLAW_CONFIG_PATH || join(homedir(), ".openclaw", "openclaw.json");
-const ENV_SOURCES = [
-  join(homedir(), ".openclaw", ".env"),
+function resolveOpenClawHome() {
+  const configPath = process.env.OPENCLAW_CONFIG_PATH?.trim();
+  if (configPath) {
+    return dirname(configPath);
+  }
+  return join(homedir(), ".openclaw");
+}
+
+const OPENCLAW_HOME = resolveOpenClawHome();
+const PRIMARY_ENV_PATH = join(OPENCLAW_HOME, ".env");
+const LEGACY_ENV_SOURCES = [
   join(homedir(), ".moltbot", ".env"),
   join(homedir(), ".clawdbot", ".env"),
 ];
+const DEFAULT_CONFIG_PATH = process.env.OPENCLAW_CONFIG_PATH || join(OPENCLAW_HOME, "openclaw.json");
+const ENV_SOURCES = [
+  PRIMARY_ENV_PATH,
+  ...LEGACY_ENV_SOURCES,
+];
 
 let cachedEnv = null;
 
@@ -97,13 +110,22 @@ function parseInteger(value, fallback, { min = Number.NEGATIVE_INFINITY, max = N
 
 export function getEnvFileStatus() {
   const env = loadEnvFiles();
+  const legacyPaths = env.foundPaths.filter((envPath) => LEGACY_ENV_SOURCES.includes(envPath));
   return {
     found: env.foundPaths.length > 0,
     paths: env.foundPaths,
     searchPaths: env.searchPaths,
+    primaryPath: PRIMARY_ENV_PATH,
+    foundPrimary: env.foundPaths.includes(PRIMARY_ENV_PATH),
+    legacyPaths,
+    usingLegacyBridge: !env.foundPaths.includes(PRIMARY_ENV_PATH) && legacyPaths.length > 0,
   };
 }
 
+export function getOpenClawHome() {
+  return OPENCLAW_HOME;
+}
+
 function resolveConfigValue(pluginConfig, configKey, envKey, fallback) {
   if (pluginConfig?.[configKey] !== undefined && pluginConfig?.[configKey] !== null && pluginConfig?.[configKey] !== "") {
     return {
@@ -142,7 +164,6 @@ function maskValue(value, { keepStart = 2, keepEnd = 2 } = {}) {
 export function getLocalUiSetupState(pluginConfig = {}, cfg = null) {
   const runtimeCfg = cfg ?? buildConfig(pluginConfig);
   const envStatus = getEnvFileStatus();
-  const targetEnvPath = envStatus.paths[0] || envStatus.searchPaths[0];
   const localOnlyMode = resolveConfigValue(
     pluginConfig,
     "localOnlyMode",
@@ -162,9 +183,12 @@ export function getLocalUiSetupState(pluginConfig = {}, cfg = null) {
       targetPath: DEFAULT_CONFIG_PATH,
     },
     envFile: {
-      targetPath: targetEnvPath,
+      targetPath: envStatus.primaryPath,
+      activePath: envStatus.paths[0] || null,
       foundPaths: envStatus.paths,
       searchPaths: envStatus.searchPaths,
+      legacyPaths: envStatus.legacyPaths,
+      usingLegacyBridge: envStatus.usingLegacyBridge,
     },
     localOnlyMode: {
       enabled: Boolean(runtimeCfg.localOnlyMode),
@@ -190,12 +214,13 @@ export function getLocalUiSetupState(pluginConfig = {}, cfg = null) {
 
 export function saveLocalUiSetup(values = {}) {
   const envStatus = getEnvFileStatus();
-  const targetPath = envStatus.paths[0] || envStatus.searchPaths[0];
+  const targetPath = envStatus.primaryPath;
+  const sourcePath = envStatus.foundPrimary ? envStatus.primaryPath : (envStatus.paths[0] || envStatus.primaryPath);
   mkdirSync(dirname(targetPath), { recursive: true });
 
   let lines = [];
   try {
-    lines = readFileSync(targetPath, "utf8").split(/\r?\n/);
+    lines = readFileSync(sourcePath, "utf8").split(/\r?\n/);
   } catch {
     lines = [];
   }
@@ -237,6 +262,8 @@ export function saveLocalUiSetup(values = {}) {
   invalidateEnvCache();
   return {
     targetPath,
+    sourcePath,
+    migratedFrom: sourcePath !== targetPath ? sourcePath : null,
     savedKeys: [...managedKeys],
   };
 }
@@ -275,7 +302,7 @@ export function buildConfig(pluginConfig = {}) {
     memoryDir: String(
       cfg.memoryDir
       || loadEnvVar("ECHOMEM_MEMORY_DIR")
-      || join(homedir(), ".openclaw", "workspace", "memory"),
+      || join(OPENCLAW_HOME, "workspace", "memory"),
     ).trim(),
   };
 }