@nowledge/openclaw-nowledge-mem 0.6.14 → 0.6.15

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to the Nowledge Mem OpenClaw plugin will be documented in this file.
 
+## [0.6.15] - 2026-03-18
+
+### Changed
+
+- **Shared config for remote credentials.** The plugin now reads `apiUrl` and `apiKey` from `~/.nowledge-mem/config.json` — the same file used by nmem CLI, Bub, Claude Code, and other integrations. One config file connects all your tools. The legacy `~/.nowledge-mem/openclaw.json` is still honored at highest priority for backward compatibility, but is no longer the recommended path. New cascade for credentials: `openclaw.json` (legacy) > OpenClaw dashboard > `config.json` (shared) > env vars > defaults.
+
+### Fixed
+
+- **Trailing slash in API URL no longer causes 404.** URLs like `https://mem.example.com/` (with trailing slash) produced double-slash paths in API fallback requests. The URL is now normalized at construction time.
+
 ## [0.6.14] - 2026-03-17
 
 ### Added

package/CLAUDE.md

@@ -9,7 +9,7 @@ Continuation guide for `community/nowledge-mem-openclaw-plugin`.
 - Memory backend: `nmem` CLI (fallback: `uvx --from nmem-cli nmem`)
 - OpenClaw minimum: `2026.3.7` (`appendSystemContext` / system-context guidance required)
 - Architecture: **CLI-first via OpenClaw runtime** - all CLI execution goes through `api.runtime.system.runCommandWithTimeout`, not direct `child_process`
-- Remote mode: set `NMEM_API_URL` + `NMEM_API_KEY` env vars or config file `apiUrl` + `apiKey`
+- Remote mode: `~/.nowledge-mem/config.json` (shared) or OpenClaw dashboard. Legacy `openclaw.json` still honored.
 
 ## Design Philosophy
 
@@ -30,7 +30,7 @@ src/
   index.js          - plugin registration (tools, hooks, commands, CLI)
   client.js         - CLI wrapper with API fallback; async runtime command execution; credential handling
   spawn-env.js      - env-only credential injection for the nmem runner
-  config.js         - config cascade: ~/.nowledge-mem/openclaw.json > pluginConfig > env vars > defaults
+  config.js         - config cascade: openclaw.json (legacy) > pluginConfig > config.json (credentials) > env > defaults
   hooks/
     behavioral.js   - always-on behavioral guidance (~50 tokens/turn)
     recall.js       - before_prompt_build: inject Working Memory + recalled memories
@@ -49,7 +49,8 @@ skills/
   memory-guide/
     SKILL.md            - agent behavioral skill: when/how to search, save, explore memory (auto-discovered by OpenClaw)
 openclaw.plugin.json - manifest + config schema (version, uiHints, configSchema, skills)
-~/.nowledge-mem/openclaw.json - optional user config file (overrides OpenClaw settings when present)
+~/.nowledge-mem/openclaw.json - legacy config file (still honored, deprecated in docs)
+~/.nowledge-mem/config.json   - shared credentials (apiUrl/apiKey) read by all Nowledge Mem tools
 ```
 
 ## Tool Surface (10 tools)
@@ -92,7 +93,8 @@ openclaw.plugin.json - manifest + config schema (version, uiHints, configSchema,
 
 ## Config Keys
 
-Optional config file at `~/.nowledge-mem/openclaw.json`. Falls through to OpenClaw plugin settings when the file is absent.
+Plugin settings: OpenClaw dashboard (pluginConfig). Legacy `~/.nowledge-mem/openclaw.json` still honored.
+Credentials (apiUrl/apiKey): also reads `~/.nowledge-mem/config.json` (shared with all Nowledge Mem tools).
 
 | Key | Type | Default | Env Var | Description |
 |-----|------|---------|---------|-------------|
@@ -105,9 +107,10 @@ Optional config file at `~/.nowledge-mem/openclaw.json`. Falls through to OpenCl
 | `apiUrl` | string | `""` | `NMEM_API_URL` | Remote server URL. Empty = local (127.0.0.1:14242) |
 | `apiKey` | string | `""` | `NMEM_API_KEY` | API key. Never logged. |
 
-**Priority**: config file > pluginConfig > env var > default.
+**Priority** (plugin-specific keys): `openclaw.json` (legacy) > pluginConfig > env var > default.
+**Priority** (apiUrl/apiKey): `openclaw.json` (legacy) > pluginConfig > `config.json` (shared) > env var > default.
 
-`parseConfig()` returns `_sources` object tracking where each value came from (`"file"`, `"pluginConfig"`, `"env"`, `"default"`). Used by `nowledge_mem_status` tool.
+`parseConfig()` returns `_sources` object tracking where each value came from (`"file"`, `"pluginConfig"`, `"sharedConfig"`, `"env"`, `"default"`). Used by `nowledge_mem_status` tool.
 
 Legacy aliases accepted silently in all sources for backward compat:
 `autoRecall`→`sessionContext`, `autoCapture`→`sessionDigest`, `captureMinInterval`→`digestMinInterval`, `maxRecallResults`→`maxContextResults`.

package/README.md

@@ -372,24 +372,18 @@ To change settings, use the OpenClaw plugin settings UI. Changes take effect on
 | `apiUrl` | string | `""` | Remote server URL. Empty = local (`http://127.0.0.1:14242`) |
 | `apiKey` | string | `""` | API key for remote access. Injected as `NMEM_API_KEY` env var, never logged |
 
-### Advanced: config file
+### Remote access
 
-For persistent or scripted config, create `~/.nowledge-mem/openclaw.json`:
+Create `~/.nowledge-mem/config.json` with your credentials. This file is shared by all Nowledge Mem integrations (nmem CLI, Bub, Claude Code, etc.) so one file connects everything:
 
 ```json
 {
-  "sessionContext": false,
-  "sessionDigest": true,
-  "digestMinInterval": 300,
-  "maxContextResults": 5,
-  "recallMinScore": 0,
-  "maxThreadMessageChars": 800,
-  "apiUrl": "",
-  "apiKey": ""
+  "apiUrl": "https://<your-url>",
+  "apiKey": "nmem_..."
 }
 ```
 
-The config file takes priority over OpenClaw settings. Only the keys you include are overridden; missing keys fall through to OpenClaw settings, then env vars, then defaults.
+See [Access Mem Anywhere](https://mem.nowledge.co/docs/remote-access).
 
 ### Advanced: environment variables
 
@@ -401,16 +395,25 @@ NMEM_SESSION_DIGEST=true
 NMEM_DIGEST_MIN_INTERVAL=300
 NMEM_MAX_CONTEXT_RESULTS=5
 NMEM_RECALL_MIN_SCORE=0
+NMEM_MAX_THREAD_MESSAGE_CHARS=800
 NMEM_API_URL=https://...
 NMEM_API_KEY=your-key
 ```
 
 ### Priority
 
+Plugin-specific settings:
 ```
-config file > OpenClaw settings > env vars > defaults
+openclaw.json (legacy) > OpenClaw dashboard > env vars > defaults
 ```
 
+Credentials (apiUrl, apiKey):
+```
+openclaw.json (legacy) > OpenClaw dashboard > config.json (shared) > env vars > defaults
+```
+
+`~/.nowledge-mem/openclaw.json` is still honored for backward compatibility but is no longer the recommended path. New users should configure plugin-specific settings via the OpenClaw dashboard and shared credentials via `~/.nowledge-mem/config.json`.
+
 Use `nowledge_mem_status` (or `openclaw nowledge-mem status`) to see where each value comes from.
 
 ### Trust warning after install

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
 	"id": "openclaw-nowledge-mem",
-	"version": "0.6.14",
+	"version": "0.6.15",
 	"kind": "memory",
 	"skills": ["skills/memory-guide"],
 	"uiHints": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nowledge/openclaw-nowledge-mem",
-	"version": "0.6.14",
+	"version": "0.6.15",
 	"type": "module",
 	"description": "Nowledge Mem memory plugin for OpenClaw, local-first personal knowledge base",
 	"author": {

package/src/client.js

@@ -83,7 +83,7 @@ export class NowledgeMemClient {
 		this.nmemCmdPromise = null;
 		// Resolved once from config + env (config wins over env, both win over default)
 		this._apiUrl =
-			(credentials.apiUrl || "").trim() || "http://127.0.0.1:14242";
+			((credentials.apiUrl || "").trim() || "http://127.0.0.1:14242").replace(/\/+$/, "");
 		this._apiKey = (credentials.apiKey || "").trim();
 	}
 

package/src/config.js

@@ -39,13 +39,20 @@ const ALIAS_KEYS = {
 	maxRecallResults: "maxContextResults",
 };
 
-// --- config file ---------------------------------------------------------
+// --- config files --------------------------------------------------------
 
 const CONFIG_DIR = join(homedir(), ".nowledge-mem");
+
+// Legacy dedicated config (deprecated — still honored for backward compat)
 const CONFIG_PATH = join(CONFIG_DIR, "openclaw.json");
 
+// Shared config read by all Nowledge Mem integrations (nmem CLI, Bub, Claude Code, etc.)
+const SHARED_CONFIG_PATH = join(CONFIG_DIR, "config.json");
+
 /**
  * Read ~/.nowledge-mem/openclaw.json if it exists.
+ * Deprecated: new users should use the OpenClaw dashboard for plugin settings
+ * and ~/.nowledge-mem/config.json for shared credentials (apiUrl, apiKey).
  * Returns {} when the file is missing or unreadable.
  */
 function readConfigFile(logger) {
@@ -64,8 +71,37 @@ function readConfigFile(logger) {
 	}
 }
 
+/**
+ * Read apiUrl and apiKey from the shared ~/.nowledge-mem/config.json.
+ * Only credentials are extracted — plugin-specific keys are ignored.
+ * Returns { apiUrl?, apiKey? } or {} when the file is missing or unreadable.
+ */
+function readSharedConfig(logger) {
+	try {
+		if (!existsSync(SHARED_CONFIG_PATH)) {
+			return {};
+		}
+		const content = readFileSync(SHARED_CONFIG_PATH, "utf-8").trim();
+		if (!content) return {};
+		const parsed = JSON.parse(content);
+		const result = {};
+		if (typeof parsed.apiUrl === "string" && parsed.apiUrl.trim()) {
+			result.apiUrl = parsed.apiUrl.trim();
+		}
+		if (typeof parsed.apiKey === "string" && parsed.apiKey.trim()) {
+			result.apiKey = parsed.apiKey.trim();
+		}
+		return result;
+	} catch (err) {
+		logger?.warn?.(
+			`nowledge-mem: could not read ${SHARED_CONFIG_PATH}: ${err instanceof Error ? err.message : err}`,
+		);
+		return {};
+	}
+}
+
 /** Exported for tests / CLI tooling. */
-export { CONFIG_PATH };
+export { CONFIG_PATH, SHARED_CONFIG_PATH };
 
 // --- env var helpers -----------------------------------------------------
 
@@ -130,11 +166,18 @@ function firstDefined(...options) {
 
 /**
  * Parse plugin config with cascade:
- *   ~/.nowledge-mem/openclaw.json > pluginConfig > env vars > defaults
  *
- * The config file (if it exists) takes highest priority so users who
- * create it get predictable behavior. Most users won't have one and
- * will configure via OpenClaw's plugin settings UI (pluginConfig).
+ *   Plugin-specific keys (sessionContext, sessionDigest, etc.):
+ *     openclaw.json (legacy) > pluginConfig (dashboard) > env vars > defaults
+ *
+ *   Credentials (apiUrl, apiKey):
+ *     openclaw.json (legacy) > pluginConfig (dashboard) > config.json (shared) > env vars > defaults
+ *
+ * Most users configure via the OpenClaw dashboard (pluginConfig) and
+ * ~/.nowledge-mem/config.json for shared credentials across all tools.
+ *
+ * ~/.nowledge-mem/openclaw.json is still honored for backward compat
+ * but is no longer the recommended path.
  *
  * Canonical keys: sessionContext, sessionDigest, digestMinInterval,
  *                 maxContextResults, recallMinScore, maxThreadMessageChars, apiUrl, apiKey
@@ -158,6 +201,7 @@ function firstDefined(...options) {
 export function parseConfig(raw, logger) {
 	const pluginCfg = raw && typeof raw === "object" ? raw : {};
 	const fileCfg = readConfigFile(logger);
+	const sharedCfg = readSharedConfig(logger);
 
 	// Resolve aliases in both sources
 	const resolvedPlugin = resolveAliases(pluginCfg);
@@ -269,7 +313,7 @@ export function parseConfig(raw, logger) {
 	);
 	_sources.maxThreadMessageChars = mtmc.source;
 
-	// --- apiUrl: file > pluginConfig > env > "" ---
+	// --- apiUrl: file (legacy) > pluginConfig > sharedConfig > env > "" ---
 	const fileUrl =
 		typeof resolvedFile.apiUrl === "string" && resolvedFile.apiUrl.trim();
 	const pluginUrl =
@@ -277,13 +321,14 @@ export function parseConfig(raw, logger) {
 	const au = firstDefined(
 		{ value: fileUrl || undefined, source: "file" },
 		{ value: pluginUrl || undefined, source: "pluginConfig" },
+		{ value: sharedCfg.apiUrl || undefined, source: "sharedConfig" },
 		{ value: envStr("NMEM_API_URL"), source: "env" },
 		{ value: "", source: "default" },
 	);
 	const apiUrl = au.value;
 	_sources.apiUrl = au.source;
 
-	// --- apiKey: file > pluginConfig > env > "" ---
+	// --- apiKey: file (legacy) > pluginConfig > sharedConfig > env > "" ---
 	const fileKey =
 		typeof resolvedFile.apiKey === "string" && resolvedFile.apiKey.trim();
 	const pluginKey =
@@ -291,6 +336,7 @@ export function parseConfig(raw, logger) {
 	const ak = firstDefined(
 		{ value: fileKey || undefined, source: "file" },
 		{ value: pluginKey || undefined, source: "pluginConfig" },
+		{ value: sharedCfg.apiKey || undefined, source: "sharedConfig" },
 		{ value: envStr("NMEM_API_KEY"), source: "env" },
 		{ value: "", source: "default" },
 	);