openclaw-amem 1.2.0 → 1.2.2

package/README.md

@@ -33,7 +33,7 @@ The first open-source A-MEM memory plugin for OpenClaw: dynamic graph linking, h
 - OpenClaw v2026.4+
 - Node.js 24 (18+ works; 24/26 supported)
 - Qdrant running on `:6333`
-- Anthropic API key (`ANTHROPIC_API_KEY`) — or set `AMEM_LLM_BASE_URL` for a compatible proxy
+- An LLM: `ANTHROPIC_API_KEY` by default, or any OpenAI-compatible provider — see [LLM provider](#llm-provider)
 
 ## Installation
 
@@ -83,6 +83,15 @@ Add `openclaw-amem` to your allowed plugins and hook it into the `memory` slot:
 openclaw gateway restart
 ```
 
+## LLM provider
+
+The plugin calls an LLM for note construction, linking, and evolution. Pick the backend with `AMEM_LLM_PROVIDER`:
+
+- **`anthropic`** (default) — the Anthropic Messages API. Set `ANTHROPIC_API_KEY`.
+- **`openai`** — the OpenAI Chat Completions API, which every OpenAI-compatible endpoint speaks. Set `AMEM_LLM_PROVIDER=openai`, point `AMEM_LLM_BASE_URL` at the endpoint, and set `AMEM_LLM_API_KEY` (or the standard `OPENAI_API_KEY`). Covers **OpenAI, DeepSeek, OpenRouter, Groq, Together**, and local servers (**Ollama, vLLM, LM Studio** — no key needed). Reasoning models (`o1`, `o3`, `gpt-5`) are handled automatically.
+
+Choose the model with `AMEM_LLM_MODEL`. Full env-var reference and examples: **[amem.owo.lc/reference/configuration](https://amem.owo.lc/reference/configuration)**.
+
 ## Configuration Reference
 
 | Key                             | Type                                      | Default  | Description                                                                                                                          |
@@ -110,7 +119,7 @@ A memory plugin's job is to read configuration from the environment and send mem
 
 What it actually does — all of it declared in [`openclaw.plugin.json`](openclaw.plugin.json):
 
-- **Environment variables it reads** (its configuration surface, supplied by you): `AMEM_LLM_PROVIDER`, `AMEM_LLM_API_KEY`, `AMEM_LLM_BASE_URL`, `AMEM_LLM_MODEL`, `AMEM_COLLECTION`, `AMEM_DATA_DIR`, `AMEM_EVO_COUNTER_PATH`, `AMEM_REVIEW_DIR`, `AMEM_PROMPT_LOCALE`. No credential is bundled, hardcoded, or logged.
+- **Environment variables it reads** (its configuration surface, supplied by you): `AMEM_LLM_PROVIDER`, `AMEM_LLM_API_KEY`, `OPENAI_API_KEY`, `AMEM_LLM_BASE_URL`, `AMEM_LLM_MODEL`, `AMEM_COLLECTION`, `AMEM_DATA_DIR`, `AMEM_EVO_COUNTER_PATH`, `AMEM_REVIEW_DIR`, `AMEM_PROMPT_LOCALE`. No credential is bundled, hardcoded, or logged.
 - **Network destinations**: only your **local Qdrant** (`http://localhost:6333`) and your configured **LLM endpoint** (Anthropic by default, or any OpenAI-compatible endpoint via `AMEM_LLM_PROVIDER=openai` + `AMEM_LLM_BASE_URL`). It sends memory text/embeddings there to store and evolve notes — its stated purpose. It does not phone home.
 - **Conversation content** is processed for memory only when you set `hooks.allowConversationAccess: true`. Keep Qdrant and review-output paths scoped to locations you control.
 

package/dist/index.js

@@ -5,8 +5,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -1838,12 +1843,9 @@ __export(index_exports, {
   ensureCollection: () => ensureCollection,
   generateReviewBatch: () => generateReviewBatch,
   getNote: () => getNote,
-  hookLiveness: () => hookLiveness,
-  hookNeverFiredWarning: () => hookNeverFiredWarning,
   invalidateNote: () => invalidateNote,
   listMemories: () => listMemories,
   listNotes: () => listNotes,
-  markHookFired: () => markHookFired,
   mergeSimilarNotes: () => mergeSimilarNotes,
   patchNotePayload: () => patchNotePayload,
   register: () => register,
@@ -1858,29 +1860,12 @@ var import_plugin_entry = require("openclaw/plugin-sdk/plugin-entry");
 init_src();
 var import_crypto2 = require("crypto");
 
-// src/hook-liveness.ts
-var HOOK_STATE_KEY = /* @__PURE__ */ Symbol.for("openclaw-amem.hookLiveness");
-var HOOK_WARN_DELAY_MS = 10 * 60 * 1e3;
-var HOOK_WARNING_TEXT = "\n\n\u26A0\uFE0F Warning: agent_end hook has never fired. Automatic memory write-back may be disabled. Set plugins.entries.openclaw-amem.hooks.allowConversationAccess=true in openclaw.json.";
-function hookLiveness(now = Date.now()) {
-  const g = globalThis;
-  let s = g[HOOK_STATE_KEY];
-  if (!s) {
-    s = { everFired: false, lastFiredAt: 0, firstSeenAt: now };
-    g[HOOK_STATE_KEY] = s;
-  }
-  return s;
-}
-function markHookFired(now = Date.now()) {
-  const s = hookLiveness(now);
-  s.everFired = true;
-  s.lastFiredAt = now;
-}
-function hookNeverFiredWarning(now = Date.now()) {
-  const s = hookLiveness(now);
-  if (s.everFired) return "";
-  if (now - s.firstSeenAt <= HOOK_WARN_DELAY_MS) return "";
-  return HOOK_WARNING_TEXT;
+// src/conv-access.ts
+var BLOCKED_WARNING_LOG = "openclaw-amem: \u26A0\uFE0F  automatic memory write-back is OFF \u2014 the agent_end hook is blocked by OpenClaw's security policy, so conversations are NOT being saved to long-term memory. Enable it: set plugins.entries.openclaw-amem.hooks.allowConversationAccess=true in openclaw.json, then restart the gateway.";
+var BLOCKED_WARNING_SUFFIX = "\n\n\u26A0\uFE0F NOTE TO ASSISTANT \u2014 please tell the user: openclaw-amem automatic memory write-back is currently DISABLED, so nothing from this conversation is being saved to long-term memory. To fix it, add `plugins.entries.openclaw-amem.hooks.allowConversationAccess: true` to openclaw.json and restart the gateway.";
+function isConvAccessBlocked(config, pluginId) {
+  const entry = config?.plugins?.entries?.[pluginId];
+  return entry !== void 0 && entry.hooks?.allowConversationAccess !== true;
 }
 
 // src/scope.ts
@@ -1910,9 +1895,11 @@ init_src();
 var _config = {};
 function register(api) {
   const logger = api.logger;
-  hookLiveness();
   _config = api.pluginConfig || {};
   const pluginConfig = _config;
+  const pluginId = api.id ?? "openclaw-amem";
+  const convBlocked = isConvAccessBlocked(api.config, pluginId);
+  if (convBlocked) logger.warn(BLOCKED_WARNING_LOG);
   configure({ dataDir: path5.join(os2.homedir(), ".openclaw") });
   const resolveAgentId2 = (ctx) => resolveAgentId(ctx, pluginConfig);
   const buildScope2 = (rawAgentId) => buildScope(rawAgentId, pluginConfig, createStorageContext);
@@ -2021,7 +2008,7 @@ function register(api) {
           async execute(_toolCallId, params) {
             const { query, limit = 5, topicsFilter } = params;
             const start = Date.now();
-            const hookWarning = hookNeverFiredWarning();
+            const hookWarning = convBlocked ? BLOCKED_WARNING_SUFFIX : "";
             try {
               const results = await searchMemory(query, limit, scope.agentId, {
                 topicsFilter,
@@ -2203,7 +2190,6 @@ ${text}${hookWarning}` }],
     hookFn(
       "agent_end",
       async (event, ctx) => {
-        markHookFired();
         const scope = buildScope2(resolveAgentId2(ctx));
         const agentId = scope.agentId;
         const storageCtx = scope.storageCtx;
@@ -2289,16 +2275,6 @@ ${mergeErr.stack}`
       { timeoutMs: 3e4 }
     );
     logger.info("openclaw-amem: agent_end CRUD decision hook registered");
-    setTimeout(
-      () => {
-        if (!hookLiveness().everFired) {
-          logger.warn(
-            "\u26A0\uFE0F openclaw-amem: agent_end hook has never fired in 10 minutes. It may be blocked by OpenClaw security policy. Add to openclaw.json: plugins.entries.openclaw-amem.hooks.allowConversationAccess=true"
-          );
-        }
-      },
-      10 * 60 * 1e3
-    );
   }
   function scheduleNextRun() {
     const now = /* @__PURE__ */ new Date();
@@ -2352,12 +2328,9 @@ var index_default = plugin;
   ensureCollection,
   generateReviewBatch,
   getNote,
-  hookLiveness,
-  hookNeverFiredWarning,
   invalidateNote,
   listMemories,
   listNotes,
-  markHookFired,
   mergeSimilarNotes,
   patchNotePayload,
   register,

package/openclaw.plugin.json

@@ -2,14 +2,14 @@
   "id": "openclaw-amem",
   "name": "Memory (A-MEM v2)",
   "description": "OpenClaw memory plugin implementing A-MEM — memories evolve, not just accumulate. Graph linking, hybrid retrieval, LLM-driven evolution. No Python.",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "kind": "memory",
   "openclaw": {
     "compat": {
       "pluginApi": ">=2026.3.24"
     },
     "build": {
-      "openclawVersion": "2026.6.9"
+      "openclawVersion": "2026.7.1-2"
     }
   },
   "contracts": {
@@ -26,7 +26,9 @@
       {
         "id": "amem",
         "envVars": [
+          "AMEM_LLM_PROVIDER",
           "AMEM_LLM_API_KEY",
+          "OPENAI_API_KEY",
           "AMEM_LLM_BASE_URL",
           "AMEM_LLM_MODEL",
           "AMEM_COLLECTION",
@@ -57,7 +59,17 @@
       "hostSuffixes": [
         ".anthropic.com"
       ],
-      "note": "LLM for note construction / link generation / evolution; override the base URL via AMEM_LLM_BASE_URL."
+      "note": "Default LLM for note construction / link generation / evolution; override the base URL via AMEM_LLM_BASE_URL."
+    },
+    {
+      "endpointClass": "openai",
+      "hosts": [
+        "api.openai.com"
+      ],
+      "hostSuffixes": [
+        ".openai.com"
+      ],
+      "note": "Alternate LLM when AMEM_LLM_PROVIDER=openai — the OpenAI Chat Completions API, or any compatible gateway (DeepSeek, OpenRouter, Groq, Together, Ollama, vLLM) selected via AMEM_LLM_BASE_URL."
     }
   ],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-amem",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "OpenClaw memory plugin implementing A-MEM — memories evolve, not just accumulate. Graph linking, hybrid retrieval, LLM-driven evolution. No Python.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
       "pluginApi": ">=2026.3.24"
     },
     "build": {
-      "openclawVersion": "2026.6.9"
+      "openclawVersion": "2026.7.1-2"
     }
   },
   "dependencies": {