clawvault 3.5.1 → 3.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Versatly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -267,24 +267,30 @@ clawvault setup --theme neural --canvas --bases
 
 ## OpenClaw Integration
 
-For hook-based lifecycle integration with OpenClaw:
+ClawVault integrates with OpenClaw as a plugin. Install the npm package, then configure it in your OpenClaw config:
 
 ```bash
-# Install and enable hook pack
-openclaw hooks install clawvault
-openclaw hooks enable clawvault
+# 1. Install the ClawVault package
+npm install clawvault
 
-# Verify
-openclaw hooks list --verbose
-openclaw hooks check
+# 2. Register the plugin and memory slot in openclaw.json
+openclaw config set plugins.entries.clawvault.package clawvault
+openclaw config set plugins.slots.memory clawvault
+
+# 3. Configure your vault path
+openclaw config set plugins.entries.clawvault.config.vaultPath ~/my-vault
+
+# 4. Verify
 clawvault compat
 ```
 
-The hook automatically:
+The plugin automatically:
 - Detects context death and injects recovery alerts
 - Auto-checkpoints before session resets
 - Provides `--profile auto` for context queries
 
+> **Legacy note:** The older `openclaw hooks install` / `openclaw hooks enable` flow is no longer the recommended path. Use the plugin model above.
+
 ### MEMORY.md vs Vault
 
 If you use both a `MEMORY.md` workspace file and a ClawVault vault, understand their roles:
@@ -351,27 +357,29 @@ clawvault compat
 
 ## OpenClaw Setup (Canonical)
 
-If you want hook-based lifecycle integration, use this sequence:
+ClawVault integrates with OpenClaw as a plugin. Use this sequence:
 
 ```bash
-# Install CLI
-npm install -g clawvault
+# Install ClawVault
+npm install clawvault
+
+# Register plugin and memory slot
+openclaw config set plugins.entries.clawvault.package clawvault
+openclaw config set plugins.slots.memory clawvault
 
-# Install and enable hook pack
-openclaw hooks install clawvault
-openclaw hooks enable clawvault
+# Configure vault path and desired features
+openclaw config set plugins.entries.clawvault.config.vaultPath ~/my-vault
+openclaw config set plugins.entries.clawvault.config.enableStartupRecovery true
+openclaw config set plugins.entries.clawvault.config.enableSessionContextInjection true
 
 # Verify
-openclaw hooks list --verbose
-openclaw hooks info clawvault
-openclaw hooks check
 clawvault compat
 ```
 
 Important:
 
-- `clawhub install clawvault` installs skill guidance, but does not replace hook-pack installation.
-- After enabling hooks, restart the OpenClaw gateway process so hook registration reloads.
+- `clawhub install clawvault` installs skill guidance, but does not replace plugin configuration.
+- After changing plugin config, restart the OpenClaw gateway process so plugin registration reloads.
 
 ## Minimal AGENTS.md Additions
 
@@ -488,10 +496,10 @@ vault/
 - `qmd` fallback errors:
   - `qmd` is optional; in-process BM25 search is available without it
   - if you want fallback compatibility, ensure `qmd --version` works in the same shell
-- Hook/plugin not active in OpenClaw:
-  - run `openclaw hooks install clawvault`
-  - run `openclaw hooks enable clawvault`
-  - verify with `openclaw hooks list --verbose`
+- Plugin not active in OpenClaw:
+  - run `openclaw config set plugins.entries.clawvault.package clawvault`
+  - run `openclaw config set plugins.slots.memory clawvault`
+  - restart the OpenClaw gateway process
 - OpenClaw integration drift:
   - run `clawvault compat`
 - Session transcript corruption:

package/dist/{chunk-X3SPPUFG.js → chunk-IFUHSHN3.js}

@@ -195,14 +195,28 @@ function checkHookHandlerSafety(options) {
   }
   return { label: "hook handler safety", status: "ok" };
 }
+function resolvePluginManifestPath(options) {
+  const packageRaw = readOptionalFile(resolveProjectFile("package.json", options.baseDir));
+  if (packageRaw) {
+    try {
+      const parsed = JSON.parse(packageRaw);
+      if (typeof parsed.openclaw?.plugin === "string") {
+        return parsed.openclaw.plugin.replace(/^\.\//, "");
+      }
+    } catch {
+    }
+  }
+  return "openclaw.plugin.json";
+}
 function checkPluginManifest(options) {
-  const manifestRaw = readOptionalFile(resolveProjectFile("hooks/clawvault/openclaw.plugin.json", options.baseDir));
+  const manifestRelPath = resolvePluginManifestPath(options);
+  const manifestRaw = readOptionalFile(resolveProjectFile(manifestRelPath, options.baseDir));
   if (!manifestRaw) {
     return {
       label: "plugin manifest",
       status: "error",
-      detail: "hooks/clawvault/openclaw.plugin.json not found",
-      hint: "Add openclaw.plugin.json to hooks/clawvault/ for config schema registration."
+      detail: `${manifestRelPath} not found`,
+      hint: "Ensure openclaw.plugin.json exists at the path declared in package.json openclaw.plugin."
     };
   }
   try {

package/dist/commands/compat.js

@@ -2,7 +2,7 @@ import {
   checkOpenClawCompatibility,
   compatCommand,
   compatibilityExitCode
-} from "../chunk-X3SPPUFG.js";
+} from "../chunk-IFUHSHN3.js";
 import "../chunk-2ZDO52B4.js";
 export {
   checkOpenClawCompatibility,

package/dist/index.js

@@ -35,7 +35,7 @@ import {
   checkOpenClawCompatibility,
   compatCommand,
   compatibilityExitCode
-} from "./chunk-X3SPPUFG.js";
+} from "./chunk-IFUHSHN3.js";
 import {
   doctor
 } from "./chunk-CSHO3PJB.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "3.5.1",
+  "version": "3.5.2",
   "description": "Structured memory system for AI agents — typed storage, knowledge graph, context profiles, canvas dashboards, neural graph themes, and Obsidian-native task views. An elephant never forgets. 🐘",
   "type": "module",
   "main": "dist/index.cjs",