@nowledge/openclaw-nowledge-mem 0.8.13 → 0.8.15

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to the Nowledge Mem OpenClaw plugin will be documented in th
 
 ## Unreleased
 
+## [0.8.15] - 2026-04-15
+
+### Fixed
+
+- **Corpus supplement now works cleanly while `memory-core` stays on the memory slot.** The plugin is now published as a dual-role OpenClaw plugin, so it can remain loaded for corpus supplement and native Nowledge Mem tools even when `memory-core` owns the primary memory slot.
+- **Supplement mode no longer shadows `memory-core`'s own `memory_search` / `memory_get` tools.** Those compatibility tools now register only when Nowledge Mem itself owns the memory slot.
+- **No local source patch should be needed for dreaming integration.** Earlier builds could fall into a broken topology where the plugin was disabled before supplement registration ever mattered, which made users patch local plugin source to keep corpus mode alive.
+
+### Changed
+
+- The OpenClaw manifest and runtime export now declare the plugin as `["memory", "context-engine"]`, which matches its real capabilities and keeps supplement mode alive beside `memory-core`.
+
+## [0.8.14] - 2026-04-14
+
+### Fixed
+
+- OpenClaw-native `dreaming` config no longer crashes plugin registration when Nowledge Mem owns the memory slot. The plugin now accepts that host-managed config object instead of rejecting it as an unknown key, so memory-core can keep running the dreaming engine alongside Nowledge Mem.
+
+### Changed
+
+- The OpenClaw manifest, validator, and docs now explicitly treat `dreaming` as a host-owned pass-through config key for memory-slot compatibility.
+
 ## [0.8.13] - 2026-04-11
 
 ### Fixed

package/CLAUDE.md

@@ -82,7 +82,7 @@ Enable when memory-core is the memory slot and you want cross-tool knowledge to
 
 ## Context Engine (CE) Architecture
 
-The plugin registers both a **memory slot** (`kind: "memory"`) and a **context engine** (`api.registerContextEngine`). These are independent registrations:
+The plugin is published as a dual-role OpenClaw plugin (`kind: ["memory", "context-engine"]`). These roles remain independent at runtime:
 
 - **Memory slot**: provides `memory_search` + `memory_get`, activates OpenClaw's "Memory Recall" system prompt section. Always active.
 - **Context engine**: activated when user sets `plugins.slots.contextEngine: "nowledge-mem"`. Replaces hooks with richer CE lifecycle.

package/README.md

@@ -240,6 +240,10 @@ When OpenClaw's memory-core is the primary memory slot and Nowledge Mem runs alo
 
 Requires OpenClaw >= 2026.4.5.
 
+As of `0.8.15`, this works without local source edits. The plugin now stays active beside `memory-core` for supplement mode, while leaving `memory-core`'s own `memory_search` / `memory_get` pair in place.
+
+If OpenClaw stores a top-level `dreaming` object on this plugin while it owns the memory slot, that is expected. Dreaming remains OpenClaw-native host config; this plugin accepts it so memory-core can run the dreaming engine alongside Nowledge Mem without registration errors.
+
 ### Three Modes at a Glance
 
 ```mermaid
@@ -428,6 +432,7 @@ To change settings, use the OpenClaw plugin settings UI. Changes take effect on
 | `corpusSupplement` | boolean | `false` | Register as a searchable corpus inside memory-core's recall and dreaming pipeline |
 | `corpusMaxResults` | integer | `5` | Max results per corpus supplement search (1-20) |
 | `corpusMinScore` | integer | `0` | Min relevance score (0-100%) for supplement results. 0 = include all |
+| `dreaming` | object | — | Optional OpenClaw-native dreaming config accepted when this plugin owns the memory slot. The host consumes it; this plugin only tolerates and preserves it |
 | `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 |
 
@@ -526,6 +531,10 @@ All 10 plugin tools register automatically when the plugin loads. No tool-level
 }
 ```
 
+**`corpusSupplement: true` is set, but startup still logs `corpus=false`**
+
+Update to `0.8.15` or newer. Older builds could disable the plugin too early when `memory-core` owned the memory slot, which made supplement mode look unavailable even on new OpenClaw builds.
+
 If `openclaw status` shows a CRITICAL warning about `plugins.allow`, this is the fix. Run `nowledge_mem_status` inside a conversation to check both plugin trust and memory slot status.
 
 Do not list `nowledge_mem_*` tool names in `tools.allow` — OpenClaw silently strips allowlists that contain only plugin entries, so the config looks active but does nothing.

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
 	"id": "openclaw-nowledge-mem",
 	"name": "Nowledge Mem",
 	"description": "Cross-tool knowledge graph memory for OpenClaw with Working Memory, graph search, and session distillation.",
-	"version": "0.8.13",
-	"kind": "memory",
+	"version": "0.8.15",
+	"kind": ["memory", "context-engine"],
 	"skills": [
 		"skills/memory-guide"
 	],
@@ -52,6 +52,10 @@
 			"label": "Corpus supplement min score (%)",
 			"help": "Minimum relevance score (0-100%) for corpus supplement results. Set to 0 to include all. Only used when corpusSupplement is enabled."
 		},
+		"dreaming": {
+			"label": "Dreaming",
+			"help": "Optional OpenClaw dreaming config consumed by the host when this plugin owns the memory slot. This plugin accepts and preserves the setting; memory-core still provides the dreaming engine."
+		},
 		"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"
@@ -143,6 +147,10 @@
 				"maximum": 100,
 				"description": "Minimum relevance score (0-100%) for corpus supplement results (only used when corpusSupplement is enabled)"
 			},
+			"dreaming": {
+				"type": "object",
+				"description": "Optional OpenClaw native dreaming config. Accepted and preserved when this plugin owns the memory slot."
+			},
 			"apiUrl": {
 				"type": "string",
 				"default": "",

package/package.json

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

package/src/config.js

@@ -26,6 +26,7 @@ const ALLOWED_KEYS = new Set([
 	"corpusSupplement",
 	"corpusMaxResults",
 	"corpusMinScore",
+	"dreaming",
 	"apiUrl",
 	"apiKey",
 	"space",
@@ -213,7 +214,7 @@ function firstDefined(...options) {
  *
  * Canonical keys: sessionContext, sessionDigest, digestMinInterval,
  *                 maxContextResults, recallMinScore, maxThreadMessageChars,
- *                 apiUrl, apiKey, space, spaceTemplate
+ *                 apiUrl, apiKey, space, spaceTemplate, dreaming
  *
  * Legacy aliases (accepted from all sources; never shown in docs):
  *   autoRecall → sessionContext
@@ -234,6 +235,12 @@ function firstDefined(...options) {
  *   NMEM_API_URL               — remote server URL
  *   NMEM_API_KEY               — API key (never logged)
  *   NMEM_SPACE                 — ambient space name (legacy: NMEM_SPACE_ID)
+ *
+ * Host-owned pass-through key:
+ *   dreaming                   — OpenClaw's native dreaming config object.
+ *                                This plugin does not interpret it, but must
+ *                                tolerate it when OpenClaw stores dreaming
+ *                                settings on the selected memory-slot owner.
  */
 export function parseConfig(raw, logger) {
 	const pluginCfg = raw && typeof raw === "object" ? raw : {};

package/src/context-engine.js

@@ -1,7 +1,8 @@
 /**
  * Nowledge Mem Context Engine for OpenClaw.
  *
- * Registers alongside the memory slot (kind: "memory"). When users activate
+ * Registers alongside the memory slot (plugin kind includes both "memory" and
+ * "context-engine"). When users activate
  * this CE via `plugins.slots.contextEngine: "nowledge-mem"`, it takes over
  * prompt assembly and adds richer lifecycle behavior:
  *

package/src/index.js

@@ -26,13 +26,14 @@ import { createStatusTool } from "./tools/status.js";
 import { createThreadFetchTool } from "./tools/thread-fetch.js";
 import { createThreadSearchTool } from "./tools/thread-search.js";
 import { createTimelineTool } from "./tools/timeline.js";
+import { resolveRegistrationMode } from "./register-mode.js";
 
 export default {
 	id: "openclaw-nowledge-mem",
 	name: "Nowledge Mem",
 	description:
 		"Local-first knowledge graph memory for AI agents — cross-AI continuity, powered by Nowledge Mem",
-	kind: "memory",
+	kind: ["memory", "context-engine"],
 
 	register(api) {
 		const logger = api.logger;
@@ -43,9 +44,19 @@ export default {
 			space: cfg.space,
 		});
 
-		// OpenClaw memory-slot compatibility (required for system prompt activation)
-		api.registerTool(createMemorySearchTool(client, logger));
-		api.registerTool(createMemoryGetTool(client, logger));
+		const { memorySlotSelected } = resolveRegistrationMode({
+			pluginId: api.id,
+			configuredMemorySlot: api.config?.plugins?.slots?.memory,
+		});
+
+		// Only the active memory slot should provide the OpenClaw-compatible
+		// memory_search / memory_get pair. When memory-core owns the slot, this
+		// plugin can still stay loaded for corpus supplement, thread sync, and
+		// native Nowledge Mem tools without shadowing memory-core's tools.
+		if (memorySlotSelected) {
+			api.registerTool(createMemorySearchTool(client, logger));
+			api.registerTool(createMemoryGetTool(client, logger));
+		}
 
 		// Nowledge Mem native tools (our differentiators)
 		api.registerTool(createSaveTool(client, logger));
@@ -61,7 +72,6 @@ export default {
 		// Diagnostics — pass runtime config so the status tool can detect:
 		//   - plugins.allow missing or not including this plugin
 		//   - memory/context-engine slot routing for capture and recall
-		const memorySlot = api.config?.plugins?.slots?.memory;
 		const contextEngineSlot = api.config?.plugins?.slots?.contextEngine;
 		const pluginsAllow = api.config?.plugins?.allow;
 		let contextEngineRegistered = false;
@@ -161,7 +171,7 @@ export default {
 
 		const remoteMode = !isDefaultApiUrl(cfg.apiUrl);
 		logger.info(
-			`nowledge-mem: initialized (context=${cfg.sessionContext}, digest=${cfg.sessionDigest}, corpus=${cfg.corpusSupplement}, mode=${remoteMode ? `remote → ${cfg.apiUrl}` : "local"})`,
+			`nowledge-mem: initialized (memorySlotSelected=${memorySlotSelected}, context=${cfg.sessionContext}, digest=${cfg.sessionDigest}, corpus=${cfg.corpusSupplement}, mode=${remoteMode ? `remote → ${cfg.apiUrl}` : "local"})`,
 		);
 	},
 };

package/src/register-mode.js

@@ -0,0 +1,9 @@
+export function resolveRegistrationMode({ pluginId, configuredMemorySlot }) {
+	const memorySlot = configuredMemorySlot ?? "memory-core";
+	const memorySlotSelected = memorySlot === pluginId;
+	return {
+		memorySlot,
+		memorySlotSelected,
+		registerMemoryCompatTools: memorySlotSelected,
+	};
+}