@nowledge/openclaw-nowledge-mem 0.8.25 → 0.8.27

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to the Nowledge Mem OpenClaw plugin will be documented in th
 
 ## Unreleased
 
+## [0.8.27] - 2026-06-26
+
+### Fixed
+
+- OpenClaw 2026.6.10+ now loads the plugin correctly. The plugin manifest declares all Nowledge Mem agent tools through `contracts.tools`, matching OpenClaw's newer tool-ownership contract and preventing startup failures such as `must declare contracts.tools before registering agent tools`.
+- Thread sync, memory search, and `nowledge_mem_status` are available again after upgrading OpenClaw and restarting the gateway.
+
+## [0.8.26] - 2026-06-10
+
+### Fixed
+
+- OpenClaw update guidance now uses `openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem --force` so stale pinned install records cannot downgrade the plugin.
+- ClawHub package metadata now requires OpenClaw 2026.5.3 or later, matching current ClawHub npm-pack artifact support and avoiding confusing archive-integrity failures on older OpenClaw installers.
+
 ## [0.8.25] - 2026-06-06
 
 ### Improved

package/README.md

@@ -9,7 +9,7 @@ This is not a flat note store. Nowledge Mem links related knowledge into a graph
 ## Requirements
 
 - [Nowledge Mem](https://mem.nowledge.co) desktop app **or** `nmem` CLI
-- [OpenClaw](https://openclaw.ai) >= 2026.4.5 (corpus supplement requires this version; core features work on >= 2026.3.7)
+- [OpenClaw](https://openclaw.ai) >= 2026.5.3 for ClawHub installs. Older 2026.4.x builds can reject current ClawHub packages with an archive integrity mismatch before the plugin is installed.
 
 ## Installation
 
@@ -19,6 +19,14 @@ openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem
 
 OpenClaw's installer writes the install record, enables the plugin, and switches the `memory` slot to `openclaw-nowledge-mem`. On current OpenClaw builds, that same install flow may also set `plugins.slots.contextEngine` to `openclaw-nowledge-mem`. Plugin `0.8.18+` accepts that automatically as a compatibility alias, so you do not need to hand-edit the file after install. If you manage config manually, keep using the canonical context engine id `nowledge-mem`.
 
+To update the plugin, re-run the ClawHub install with `--force`:
+
+```bash
+openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem --force
+```
+
+Use this instead of `openclaw plugins update openclaw-nowledge-mem` when an old install record is pinned to a specific version.
+
 Restart OpenClaw after install to load it.
 
 If OpenClaw previously blocked the ClawHub package with a warning about
@@ -127,7 +135,7 @@ NMEM_SPACE="Research Agent"
 
 Nowledge Mem's CLI-backed Working Memory, memory search/save, and the plugin's API-backed thread/feed fallbacks will then stay in that lane together. There is no second OpenClaw-only vault setting; the shared Mem boundary is still one hidden space key, but humans and agents should normally work with the space name instead.
 
-For multi-agent orchestrators, set `NMEM_AGENT_ID=<agent-slug>` per spawned OpenClaw worker. Add `NMEM_SPACE` only when that run should override the AI Identity's default space. `NMEM_HOST_AGENT_ID` is for advanced host-id aliases. Context Bundle will use the stable identity while keeping `source_app=openclaw` for provenance. Keep these as launcher environment variables instead of plugin config keys so OpenClaw's strict config validation remains stable.
+For multi-agent orchestrators, set `NMEM_AGENT_ID=<agent-slug>` per spawned OpenClaw worker. Add `NMEM_SPACE` only when that run should override the AI Identity's default space. `NMEM_HOST_AGENT_ID` is for advanced external aliases. Context Bundle will use the stable identity while keeping `source_app=openclaw` for provenance. Keep these as launcher environment variables instead of plugin config keys so OpenClaw's strict config validation remains stable.
 
 Shared spaces, default retrieval, and agent guidance still live in Mem's own space profile. OpenClaw chooses the lane and preserves it across transports; it should not duplicate the profile semantics.
 
@@ -548,6 +556,8 @@ All 10 plugin tools register automatically when the plugin loads. No tool-level
 }
 ```
 
+If OpenClaw logs `must declare contracts.tools before registering agent tools`, update the plugin to `0.8.27` or newer and restart OpenClaw. That error means a newer OpenClaw build is enforcing plugin tool ownership metadata before it accepts runtime tool registration.
+
 **`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.

package/SKILL.md

@@ -106,6 +106,15 @@ Default install:
 openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem
 ```
 
+If this fails with `archive integrity mismatch`, update OpenClaw first, then
+retry. Current ClawHub packages require OpenClaw 2026.5.3 or later.
+
+To update an existing install:
+
+```bash
+openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem --force
+```
+
 Alternatively, if the user is installing from OpenClaw's default registry rather than ClawHub, this also works:
 
 ```bash
@@ -240,10 +249,12 @@ What to expect:
 | `nmem --json status` fails in local mode | Start Nowledge Mem locally first |
 | Remote mode fails | Re-run `nmem --json --api-url ... status` with the exact URL and auth you plan to use |
 | `openclaw nowledge-mem status` fails after install | Restart OpenClaw and confirm the plugin was installed successfully |
+| ClawHub reports `archive integrity mismatch` | Update OpenClaw to 2026.5.3+ or latest, then reinstall with `openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem --force` |
 | `plugins.allow is empty` warning | Add `openclaw-nowledge-mem` to `plugins.allow` if the user wants explicit trust |
 | Remote config seems ignored | Check whether `~/.nowledge-mem/openclaw.json` is overriding plugin settings |
 | Local mode unexpectedly talks to a remote server | Check for stale `NMEM_API_URL` / `NMEM_API_KEY` in the environment or an overriding `~/.nowledge-mem/openclaw.json` |
 | Plugin tools missing | Ensure the plugin is in `plugins.allow: ["openclaw-nowledge-mem"]`. Do **not** put `nowledge_mem_*` tool names in `tools.allow` — OpenClaw silently strips plugin-only allowlists. No `tools.*` config is needed; plugin tools load automatically when the plugin is allowed. |
+| `must declare contracts.tools before registering agent tools` | Update the plugin to `0.8.27+` and restart OpenClaw. Newer OpenClaw builds require plugin authors to declare tool ownership in the manifest before runtime tool registration. |
 
 ## Notes for Agents
 

package/openclaw.plugin.json

@@ -2,8 +2,22 @@
 	"id": "openclaw-nowledge-mem",
 	"name": "Nowledge Mem",
 	"description": "Cross-tool knowledge graph memory for OpenClaw with startup context, graph search, and session distillation.",
-	"version": "0.8.25",
+	"version": "0.8.27",
 	"kind": ["memory", "context-engine"],
+	"contracts": {
+		"tools": [
+			"memory_search",
+			"memory_get",
+			"nowledge_mem_save",
+			"nowledge_mem_context",
+			"nowledge_mem_connections",
+			"nowledge_mem_timeline",
+			"nowledge_mem_forget",
+			"nowledge_mem_thread_search",
+			"nowledge_mem_thread_fetch",
+			"nowledge_mem_status"
+		]
+	},
 	"skills": [
 		"skills/memory-guide"
 	],

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@nowledge/openclaw-nowledge-mem",
 	"displayName": "Nowledge Mem for OpenClaw",
-	"version": "0.8.25",
+	"version": "0.8.27",
 	"type": "module",
 	"description": "Nowledge Mem memory plugin for OpenClaw, local-first personal knowledge base",
 	"author": {
@@ -29,13 +29,15 @@
 			"./src/index.js"
 		],
 		"install": {
-			"npmSpec": "@nowledge/openclaw-nowledge-mem"
+			"clawhubSpec": "clawhub:@nowledge/openclaw-nowledge-mem",
+			"npmSpec": "@nowledge/openclaw-nowledge-mem",
+			"defaultChoice": "clawhub"
 		},
 		"compat": {
-			"pluginApi": ">=2026.4.5"
+			"pluginApi": ">=2026.5.3"
 		},
 		"build": {
-			"openclawVersion": "2026.4.5"
+			"openclawVersion": "2026.6.10"
 		},
 		"release": {
 			"publishToClawHub": true,