@icex-labs/openclaw-memory-engine 4.2.0 → 4.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icex-labs/openclaw-memory-engine",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "description": "MemGPT-style hierarchical memory plugin for OpenClaw — core memory block + archival storage with semantic search",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -117,11 +117,14 @@ if command -v node &>/dev/null && [ -f "$PLUGIN_DIR/extras/migrate-legacy.mjs" ]
   # Check if there are legacy files to migrate
   legacy_count=0
   [ -f "$WORKSPACE/MEMORY.md" ] && legacy_count=$((legacy_count + 1))
-  legacy_count=$((legacy_count + $(ls "$MEMORY_DIR"/*.md 2>/dev/null | wc -l | tr -d ' ')))
-  legacy_count=$((legacy_count + $(ls "$MEMORY_DIR"/weekly/*.md 2>/dev/null | wc -l | tr -d ' ')))
-  legacy_count=$((legacy_count + $(ls "$MEMORY_DIR"/topics/*.md 2>/dev/null | wc -l | tr -d ' ')))
+  md_count=$(find "$MEMORY_DIR" -maxdepth 1 -name "*.md" 2>/dev/null | wc -l | tr -d ' ' || true)
+  weekly_count=$(find "$MEMORY_DIR/weekly" -name "*.md" 2>/dev/null | wc -l | tr -d ' ' || true)
+  topics_count=$(find "$MEMORY_DIR/topics" -name "*.md" 2>/dev/null | wc -l | tr -d ' ' || true)
+  : "${md_count:=0}" "${weekly_count:=0}" "${topics_count:=0}"
+  legacy_count=$((legacy_count + md_count + weekly_count + topics_count))
 
-  archival_count=$(wc -l < "$MEMORY_DIR/archival.jsonl" 2>/dev/null | tr -d ' ' || echo "0")
+  archival_count=0
+  [ -f "$MEMORY_DIR/archival.jsonl" ] && archival_count=$(wc -l < "$MEMORY_DIR/archival.jsonl" | tr -d ' ')
 
   if [ "$legacy_count" -gt 0 ] && [ "$archival_count" -lt 10 ]; then
     echo ""
@@ -150,11 +153,12 @@ fi
 SCRIPTS_DIR="$WORKSPACE/scripts"
 mkdir -p "$SCRIPTS_DIR"
 if [ ! -f "$SCRIPTS_DIR/memory-maintenance.sh" ]; then
-  cp "$PLUGIN_DIR/extras/memory-maintenance.sh" "$SCRIPTS_DIR/memory-maintenance.sh" 2>/dev/null || {
+  if cp "$PLUGIN_DIR/extras/memory-maintenance.sh" "$SCRIPTS_DIR/memory-maintenance.sh" 2>/dev/null; then
+    chmod +x "$SCRIPTS_DIR/memory-maintenance.sh" 2>/dev/null || true
+    echo "✅ memory-maintenance.sh installed"
+  else
     echo "⚠️  memory-maintenance.sh not found in extras/. Copy manually."
-  }
-  chmod +x "$SCRIPTS_DIR/memory-maintenance.sh" 2>/dev/null
-  echo "✅ memory-maintenance.sh installed"
+  fi
 else
   echo "⏭️  memory-maintenance.sh already exists"
 fi
@@ -283,41 +287,25 @@ if [ -f "$AGENTS_MD" ]; then
   if ! grep -q "core_memory_read" "$AGENTS_MD"; then
     cat >> "$AGENTS_MD" <<'PATCH'
 
-## Memory System — MemGPT Architecture
-
-You have 19 memory tools. **Use them actively.**
-
-### Core Memory (`core_memory_read` / `core_memory_replace` / `core_memory_append`)
-- Call `core_memory_read` at **every session start**
-- `core_memory_replace` when facts change
-- `current_focus` max 5 items — update frequently
-- Hard limit: 3KB — move details to archival
-
-### Archival Memory (`archival_insert` / `archival_search` / `archival_update` / `archival_delete`)
-- `archival_insert`: store facts with entity + tags + importance (1-10)
-- `archival_search`: hybrid keyword + semantic search. Use before guessing.
-- `archival_update`/`archival_delete`: correct or remove outdated facts
-
-### Knowledge Graph (`graph_query` / `graph_add`)
-- Auto-extracted from archival_insert (relations like has_doctor, owns, lives_in)
-- `graph_query`: traverse from entity to find connections
-- `graph_add`: manually add relations
-
-### Episodic Memory (`episode_save` / `episode_recall`)
-- `episode_save`: at end of meaningful conversations (summary, decisions, mood, topics)
-- `episode_recall`: "what did we discuss about X last time?"
-
-### Maintenance
-- `memory_reflect`: analyze patterns (use during heartbeats)
-- `archival_deduplicate`: clean near-duplicate facts
-- `memory_consolidate`: extract facts from text blocks
-- `memory_dashboard`: generate browsable HTML dashboard
-
-### Memory Discipline
-- If it matters → `archival_insert` it. "Mental notes" don't survive restarts.
-- Don't guess → `archival_search` first.
-- End of conversation → `episode_save`.
-- Update core memory proactively.
+## Memory System (memory-engine plugin v4.2)
+
+**Memory is automatic.** All conversations are captured by hooks — you don't need to manually save anything.
+
+### What NOT to do
+- **Don't say "I'll remember that" or "recorded"** — memory happens silently
+- **Don't call `archival_insert` for conversation content** — hooks already capture it
+- Just be natural. Like a person who actually remembers things.
+
+### When to use tools manually
+- `core_memory_read` — call at **every session start** to load your identity
+- `core_memory_replace` / `core_memory_append` — when identity facts change
+- `archival_search` — **before answering factual questions** (don't guess)
+- `archival_insert` — only for non-conversation sources (web_fetch results, file contents)
+- `archival_update` / `archival_delete` — correct or remove wrong facts
+- `graph_query` — answer relational questions ("who is my doctor?")
+- `episode_save` — at end of meaningful conversations (summary, decisions, mood)
+- `episode_recall` — "what did we discuss about X last time?"
+- `memory_reflect` — during heartbeats to analyze patterns
 PATCH
     echo "✅ AGENTS.md patched with memory instructions"
   else
@@ -449,12 +437,17 @@ echo "  2. Restart gateway: openclaw gateway restart"
 echo "  3. Test: openclaw agent -m 'core_memory_read'"
 echo "  4. Dashboard: open $MEMORY_DIR/dashboard.html"
 echo ""
-echo "19 tools ready:"
+echo "20 tools + 2 hooks ready:"
+echo "  Hooks:    auto-capture incoming messages + agent replies (passive)"
 echo "  Core:     core_memory_read, core_memory_replace, core_memory_append"
 echo "  Archival: archival_insert/search/update/delete/stats"
 echo "  Graph:    graph_query, graph_add"
 echo "  Episodes: episode_save, episode_recall"
 echo "  Reflect:  memory_reflect"
+echo "  Quality:  memory_quality"
 echo "  Maint:    archival_deduplicate, memory_consolidate"
 echo "  Backup:   memory_export, memory_import"
 echo "  Admin:    memory_migrate, memory_dashboard"
+echo ""
+echo "Memory is automatic — hooks capture all conversations."
+echo "Your agent doesn't need to say 'I'll remember that.'"