@nowledge/openclaw-nowledge-mem 0.6.13 → 0.6.15

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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
+
+- **Configurable thread message truncation.** New `maxThreadMessageChars` setting (200-20000, default 800) controls how many characters are preserved per captured thread message. Higher values keep more context in long conversations. Configurable via dashboard, config file, or `NMEM_MAX_THREAD_MESSAGE_CHARS` env var. Contributed by @blessonism.
+
 ## [0.6.13] - 2026-03-17
 
 ### Fixed

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 |
 |-----|------|---------|---------|-------------|
@@ -101,12 +103,14 @@ Optional config file at `~/.nowledge-mem/openclaw.json`. Falls through to OpenCl
 | `digestMinInterval` | integer 0-86400 | `300` | `NMEM_DIGEST_MIN_INTERVAL` | Minimum seconds between session digests |
 | `maxContextResults` | integer 1-20 | `5` | `NMEM_MAX_CONTEXT_RESULTS` | How many memories to inject at prompt time |
 | `recallMinScore` | integer 0-100 | `0` | `NMEM_RECALL_MIN_SCORE` | Min relevance score (%) to include in auto-recall |
+| `maxThreadMessageChars` | integer 200-20000 | `800` | `NMEM_MAX_THREAD_MESSAGE_CHARS` | Max chars per captured thread message before truncation |
 | `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`.
@@ -156,6 +160,16 @@ nmem wm patch --heading "## Notes" --append "New note from agent"
 NMEM_API_URL=https://your-server NMEM_API_KEY=key nmem status
 ```
 
+## Version Bump Checklist
+
+All three files must match on every release:
+
+1. **`package.json`** — `"version"` (npm registry reads this for `npm publish`)
+2. **`openclaw.plugin.json`** — `"version"` (OpenClaw runtime reads this at load time)
+3. **`CHANGELOG.md`** — new `## [x.y.z] - YYYY-MM-DD` section header
+
+After bumping, commit inside the `community/` submodule, then stage the updated submodule ref in the parent repo.
+
 ## Known Gaps / Accepted Limitations
 
 1. **Feed API `date_from`/`date_to`** - supported. Backend filters events by YYYY-MM-DD range. CLI: `nmem f --from/--to`. Plugin: `nowledge_mem_timeline` accepts `date_from`/`date_to`.

package/README.md

@@ -368,26 +368,22 @@ To change settings, use the OpenClaw plugin settings UI. Changes take effect on
 | `digestMinInterval` | integer | `300` | Minimum seconds between session digests for the same thread (0-86400) |
 | `maxContextResults` | integer | `5` | Max memories to inject at prompt time (1-20, only used when sessionContext is enabled) |
 | `recallMinScore` | integer | `0` | Min relevance score (0-100%) to include in auto-recall. 0 = include all |
+| `maxThreadMessageChars` | integer | `800` | Maximum characters preserved per captured OpenClaw thread message before truncation |
 | `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,
-  "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
 
@@ -399,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.13",
+	"version": "0.6.15",
 	"kind": "memory",
 	"skills": ["skills/memory-guide"],
 	"uiHints": {
@@ -24,6 +24,10 @@
 			"label": "Min recall score (%)",
 			"help": "Only inject memories with relevance score above this threshold (0-100). Set to 0 to include all results."
 		},
+		"maxThreadMessageChars": {
+			"label": "Max thread message chars",
+			"help": "Maximum characters preserved per captured OpenClaw thread message (200-20000). Higher values keep more of long messages in Nowledge thread history."
+		},
 		"apiUrl": {
 			"label": "Server URL (remote mode)",
 			"help": "Leave empty for local mode (default: http://127.0.0.1:14242). Set to your remote server URL for cross-device or team access. See: https://docs.nowledge.co/docs/remote-access"
@@ -68,6 +72,13 @@
 				"maximum": 100,
 				"description": "Minimum relevance score (0-100%) to include a memory in auto-recall. Set to 0 to include all results."
 			},
+			"maxThreadMessageChars": {
+				"type": "integer",
+				"default": 800,
+				"minimum": 200,
+				"maximum": 20000,
+				"description": "Maximum characters preserved per captured OpenClaw thread message before truncation."
+			},
 			"apiUrl": {
 				"type": "string",
 				"default": "",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nowledge/openclaw-nowledge-mem",
-	"version": "0.6.13",
+	"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

@@ -20,6 +20,7 @@ const ALLOWED_KEYS = new Set([
 	"digestMinInterval",
 	"maxContextResults",
 	"recallMinScore",
+	"maxThreadMessageChars",
 	"apiUrl",
 	"apiKey",
 	// Legacy aliases — accepted but not advertised
@@ -38,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) {
@@ -63,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 -----------------------------------------------------
 
@@ -129,14 +166,21 @@ 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, apiUrl, apiKey
+ *                 maxContextResults, recallMinScore, maxThreadMessageChars, apiUrl, apiKey
  *
  * Legacy aliases (accepted from all sources; never shown in docs):
  *   autoRecall → sessionContext
@@ -150,12 +194,14 @@ function firstDefined(...options) {
  *   NMEM_DIGEST_MIN_INTERVAL   — seconds (0-86400)
  *   NMEM_MAX_CONTEXT_RESULTS   — integer (1-20)
  *   NMEM_RECALL_MIN_SCORE      — integer (0-100)
+ *   NMEM_MAX_THREAD_MESSAGE_CHARS — integer (200-20000)
  *   NMEM_API_URL               — remote server URL
  *   NMEM_API_KEY               — API key (never logged)
  */
 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);
@@ -250,7 +296,24 @@ export function parseConfig(raw, logger) {
 	const recallMinScore = Math.min(100, Math.max(0, Math.trunc(rms.value)));
 	_sources.recallMinScore = rms.source;
 
-	// --- apiUrl: file > pluginConfig > env > "" ---
+	// --- maxThreadMessageChars: file > pluginConfig > env > default ---
+	const mtmcEnv = envInt("NMEM_MAX_THREAD_MESSAGE_CHARS");
+	const mtmc = firstDefined(
+		{ value: pickNum(resolvedFile, "maxThreadMessageChars"), source: "file" },
+		{
+			value: pickNum(resolvedPlugin, "maxThreadMessageChars"),
+			source: "pluginConfig",
+		},
+		{ value: mtmcEnv, source: "env" },
+		{ value: 800, source: "default" },
+	);
+	const maxThreadMessageChars = Math.min(
+		20000,
+		Math.max(200, Math.trunc(mtmc.value)),
+	);
+	_sources.maxThreadMessageChars = mtmc.source;
+
+	// --- apiUrl: file (legacy) > pluginConfig > sharedConfig > env > "" ---
 	const fileUrl =
 		typeof resolvedFile.apiUrl === "string" && resolvedFile.apiUrl.trim();
 	const pluginUrl =
@@ -258,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 =
@@ -272,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" },
 	);
@@ -284,6 +349,7 @@ export function parseConfig(raw, logger) {
 		digestMinInterval,
 		maxContextResults,
 		recallMinScore,
+		maxThreadMessageChars,
 		apiUrl,
 		apiKey,
 		_sources,

package/src/hooks/capture.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
 
-const MAX_MESSAGE_CHARS = 800;
+const DEFAULT_MAX_MESSAGE_CHARS = 800;
 const MAX_DISTILL_MESSAGE_CHARS = 2000;
 const MAX_CONVERSATION_CHARS = 30_000;
 const MIN_MESSAGES_FOR_DISTILL = 4;
@@ -23,7 +23,7 @@ function _setLastCapture(threadId, now) {
 	}
 }
 
-function truncate(text, max = MAX_MESSAGE_CHARS) {
+function truncate(text, max = DEFAULT_MAX_MESSAGE_CHARS) {
 	const str = String(text || "").trim();
 	if (!str) return "";
 	return str.length > max ? `${str.slice(0, max)}…` : str;
@@ -48,7 +48,7 @@ function extractText(content) {
 	return parts.join("\n").trim();
 }
 
-function normalizeRoleMessage(raw) {
+function normalizeRoleMessage(raw, maxMessageChars = DEFAULT_MAX_MESSAGE_CHARS) {
 	if (!raw || typeof raw !== "object") return null;
 	const msg =
 		raw.message && typeof raw.message === "object" ? raw.message : raw;
@@ -80,7 +80,7 @@ function normalizeRoleMessage(raw) {
 
 	return {
 		role,
-		content: truncate(text),
+		content: truncate(text, maxMessageChars),
 		fullContent: text,
 		timestamp,
 		externalHint,
@@ -170,7 +170,7 @@ async function resolveHookMessages(event) {
 	return loadMessagesFromSessionFile(sessionFile);
 }
 
-async function appendOrCreateThread({ client, logger, event, ctx, reason }) {
+async function appendOrCreateThread({ client, logger, event, ctx, reason, maxMessageChars = DEFAULT_MAX_MESSAGE_CHARS }) {
 	const rawMessages = await resolveHookMessages(event);
 	if (!Array.isArray(rawMessages) || rawMessages.length === 0) return;
 
@@ -178,7 +178,9 @@ async function appendOrCreateThread({ client, logger, event, ctx, reason }) {
 	const sessionKey = String(ctx?.sessionKey || ctx?.sessionId || "session");
 	const sessionId = String(ctx?.sessionId || "").trim();
 	const title = buildThreadTitle(ctx, reason);
-	const normalized = rawMessages.map(normalizeRoleMessage).filter(Boolean);
+	const normalized = rawMessages
+		.map((message) => normalizeRoleMessage(message, maxMessageChars))
+		.filter(Boolean);
 	if (normalized.length === 0) return;
 
 	const messages = normalized.map((message, index) => ({
@@ -291,6 +293,7 @@ export function buildAgentEndCaptureHandler(client, cfg, logger) {
 			event,
 			ctx,
 			reason: "agent_end",
+			maxMessageChars: cfg.maxThreadMessageChars,
 		});
 
 		// 2. Triage + distill: language-agnostic LLM-based capture.
@@ -376,6 +379,13 @@ export function buildAgentEndCaptureHandler(client, cfg, logger) {
 export function buildBeforeResetCaptureHandler(client, _cfg, logger) {
 	return async (event, ctx) => {
 		const reason = typeof event?.reason === "string" ? event.reason : undefined;
-		await appendOrCreateThread({ client, logger, event, ctx, reason });
+		await appendOrCreateThread({
+			client,
+			logger,
+			event,
+			ctx,
+			reason,
+			maxMessageChars: _cfg?.maxThreadMessageChars,
+		});
 	};
 }

package/src/tools/status.js

@@ -109,6 +109,9 @@ export function createStatusTool(client, _logger, cfg) {
 			lines.push(
 				`  recallMinScore: ${cfg.recallMinScore}% (${sources.recallMinScore || "?"})`,
 			);
+			lines.push(
+				`  maxThreadMessageChars: ${cfg.maxThreadMessageChars} (${sources.maxThreadMessageChars || "?"})`,
+			);
 
 			details.config = {
 				sessionContext: {
@@ -131,6 +134,10 @@ export function createStatusTool(client, _logger, cfg) {
 					value: cfg.recallMinScore,
 					source: sources.recallMinScore,
 				},
+				maxThreadMessageChars: {
+					value: cfg.maxThreadMessageChars,
+					source: sources.maxThreadMessageChars,
+				},
 				apiUrl: { value: cfg.apiUrl || "(local)", source: sources.apiUrl },
 				apiKey: {
 					value: cfg.apiKey ? "(set)" : "(not set)",