@mem9/mem9 0.4.8-alpha.0 → 0.4.9

package/README.md

@@ -31,6 +31,9 @@ Add mem9 to your project's `openclaw.json`:
     "entries": {
       "mem9": {
         "enabled": true,
+        "hooks": {
+          "allowConversationAccess": true
+        },
         "config": {
           "apiUrl": "http://localhost:8080",
           "apiKey": "uuid",
@@ -146,6 +149,9 @@ Each agent uses the same `apiKey` for the shared memory pool. The plugin sends t
     "entries": {
       "mem9": {
         "enabled": true,
+        "hooks": {
+          "allowConversationAccess": true
+        },
         "config": {
           "apiUrl": "http://your-server:8080",
           "apiKey": "uuid"
@@ -156,7 +162,7 @@ Each agent uses the same `apiKey` for the shared memory pool. The plugin sends t
 }
 ```
 
-That's it. The server handles scoping and conflict resolution. Conceptually, the only required values are `apiUrl` + `apiKey`.
+That's it. The server handles scoping and conflict resolution. Conceptually, the required mem9 credential values are `apiUrl` + `apiKey`; OpenClaw 4.23+ also needs the entry-level hook permission shown above for automatic conversation upload.
 
 ### Verify
 
@@ -184,7 +190,9 @@ Defined in `openclaw.plugin.json`:
 | `debugRecall` | boolean | Deprecated alias for `debug` |
 | `tenantID` | string | Legacy alias for `apiKey`. The plugin still uses `/v1alpha2/mem9s/...` with `X-API-Key`. |
 
-> **Note**: `apiKey` takes precedence when both fields are set. If only `tenantID` is present, the plugin treats it as a legacy alias for `apiKey`, still uses v1alpha2, and logs a deprecation warning once at startup. `provisionToken` and `provisionQueryParams` are ignored after an `apiKey` is already configured, and non-`utm_*` keys are dropped before the provision request is sent. During create-new onboarding, the plugin shares one in-flight provision result across concurrent local registrations and reuses the persisted result for the same `provisionToken`, so repeated reloads or repeated setup retries do not create multiple keys.
+> **Note**: `apiKey` takes precedence when both fields are set. If only `tenantID` is present, the plugin treats it as a legacy alias for `apiKey`, still uses v1alpha2, and logs a deprecation warning once at startup. `provisionToken` and `provisionQueryParams` are ignored after an `apiKey` is already configured, and non-`utm_*` keys are dropped before the provision request is sent. During create-new onboarding, the plugin shares one in-flight provision result across concurrent local registrations and reuses the persisted result for the same `provisionToken`, so repeated reloads or repeated setup retries do not create multiple keys. The only valid secret path is `plugins.entries.mem9.config.apiKey`; `plugins.entries.mem9.apiKey` at the entry top level is invalid on OpenClaw and prevents the gateway from loading.
+
+OpenClaw 4.23+ / 2026.4.22+ requires the entry-level hook policy `plugins.entries.mem9.hooks.allowConversationAccess = true` for `agent_end` to include conversation messages. Without it, mem9 can still load, but automatic conversation upload cannot read the conversation to ingest it. This is an OpenClaw plugin-entry permission, not a mem9 `config` field. Older OpenClaw builds that reject this hook policy should omit the `hooks` block and upgrade for full automatic conversation upload.
 
 For debugging, set `"debug": true` in the plugin config. The plugin will emit `[mem9][debug]` lines; current coverage shows how `before_prompt_build` stripped OpenClaw metadata wrappers before issuing the recall search. `"debugRecall": true` still works as a deprecated alias.
 
@@ -201,8 +209,11 @@ Example:
 {
   "plugins": {
     "entries": {
-      "openclaw": {
+      "mem9": {
         "enabled": true,
+        "hooks": {
+          "allowConversationAccess": true
+        },
         "config": {
           "apiUrl": "http://your-server:8080",
           "apiKey": "uuid",
@@ -235,6 +246,8 @@ openclaw-plugin/
 |---|---|---|
 | `No mode configured` | Missing config | Add `apiUrl` and `apiKey` (or legacy `tenantID`) to plugin config |
 | `Server mode requires...` | Missing key | Add `apiKey` (or legacy `tenantID`) to config |
+| `config reload skipped (invalid config): plugins.entries.mem9: Unrecognized key: "apiKey"` | Setup wrote `plugins.entries.mem9.apiKey` instead of `plugins.entries.mem9.config.apiKey` | Remove the invalid top-level key and keep the secret only under `config.apiKey` |
 | Multiple auto-provisioned keys appear during create-new | Setup retriggered create-new provisioning before the first result was reused, or an older plugin still auto-provisions on startup | Upgrade to `@mem9/mem9@0.4.7+`; newer builds provision only from the first post-restart user message and reuse one local result across duplicate setup retries |
 | Search requests time out | Hybrid/vector search exceeds plugin timeout | Increase `searchTimeoutMs` in plugin config |
+| Conversations are not uploaded on OpenClaw 4.23+ | `agent_end` does not include conversation messages without explicit hook permission | Set `plugins.entries.mem9.hooks.allowConversationAccess` to `true` and restart OpenClaw |
 | Plugin not loading | Not in memory slot | Set `"slots": {"memory": "mem9"}` in openclaw.json |

package/hooks.ts

@@ -212,6 +212,7 @@ export function registerHooks(
   },
 ): void {
   const maxIngestBytes = options?.maxIngestBytes ?? DEFAULT_MAX_INGEST_BYTES;
+  let loggedMissingConversationAccess = false;
 
   // --------------------------------------------------------------------------
   // before_prompt_build — inject relevant memories into every LLM call
@@ -335,7 +336,17 @@ export function registerHooks(
         agentId?: string;
       };
       const hookCtx = (context ?? {}) as HookContext;
-      if (!evt?.success || !evt.messages || evt.messages.length === 0) return;
+      if (!evt?.success) return;
+      if (!Array.isArray(evt.messages)) {
+        if (!loggedMissingConversationAccess) {
+          logger.info(
+            "[mem9] agent_end conversation messages are unavailable; on OpenClaw 4.23+ / 2026.4.22+ set plugins.entries.mem9.hooks.allowConversationAccess=true to enable automatic conversation upload",
+          );
+          loggedMissingConversationAccess = true;
+        }
+        return;
+      }
+      if (evt.messages.length === 0) return;
 
       // Skip cron/heartbeat-triggered runs — they produce low-value messages
       if (hookCtx.trigger === "cron" || hookCtx.trigger === "heartbeat") {
@@ -351,11 +362,6 @@ export function registerHooks(
         const role = typeof m.role === "string" ? m.role : "";
         if (!role) continue;
 
-        // Skip cron tool results — structured JSON job definitions with no memory value
-        if (role === "toolResult" && typeof m.toolName === "string" && m.toolName === "cron") {
-          continue;
-        }
-
         let content = "";
         if (typeof m.content === "string") {
           content = m.content;

package/index.test.ts

@@ -479,6 +479,27 @@ test("debugRecall still works as a deprecated alias for debug", async () => {
   }
 });
 
+test("agent_end logs conversation-access diagnostic once when messages are unavailable", async () => {
+  const infoLogs: string[] = [];
+  const api = createStubApi(
+    {
+      apiUrl: uniqueApiUrl("agent-end-no-messages"),
+      apiKey: "space-agent-end-no-messages",
+    },
+    { infoLogs },
+  );
+  mnemoPlugin.register(api);
+
+  const agentEnd = api.getHook("agent_end");
+  await agentEnd({ success: true });
+  await agentEnd({ success: true });
+
+  assert.equal(
+    infoLogs.filter((line) => line.includes("allowConversationAccess=true")).length,
+    1,
+  );
+});
+
 test("first post-restart prompt provisions once and unlocks memory access", async () => {
   const originalFetch = globalThis.fetch;
   const apiUrl = uniqueApiUrl("explicit-provision");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mem9/mem9",
-  "version": "0.4.8-alpha.0",
+  "version": "0.4.9",
   "description": "OpenClaw shared memory plugin — cloud-persistent memory with hybrid vector + keyword search via mnemo-server",
   "type": "module",
   "license": "Apache-2.0",