Smart Memory v2 Skill

Smart Memory v2 is a persistent cognitive memory runtime, not a legacy vector-memory CLI.

Core runtime:

• Node adapter: smart-memory/index.js
• Local API: server.py (FastAPI)
• Orchestrator: cognitive_memory_system.py

Core Capabilities

• Structured long-term memory (episodic, semantic, belief, goal)
• Entity-aware retrieval and reranking
• Hot working memory
• Background cognition (reflection, consolidation, decay, conflict resolution)
• Strict token-bounded prompt composition
• Observability endpoints (/health, /memories, /memory/{id}, /insights/pending)

Native OpenClaw Integration (v2.5)

Use the native OpenClaw skill package:

• skills/smart-memory-v25/index.js
• Optional hook helper: skills/smart-memory-v25/openclaw-hooks.js
• Skill descriptor: skills/smart-memory-v25/SKILL.md

Primary exports:

• createSmartMemorySkill(options)
• createOpenClawHooks({ skill, agentIdentity, summarizeWithLLM })

Tool Interface (for agent tool use)

1. memory_search

• Purpose: query long-term memory.
• Input:
  • query (string, required)
  • type (all|semantic|episodic|belief|goal, default all)
  • limit (number, default 5)
  • min_relevance (number, default 0.6)
• Behavior: checks /health first, then retrieves via /retrieve and returns formatted memory results.

2. memory_commit

• Purpose: explicitly persist important facts/decisions/beliefs/goals.
• Input:
  • content (string, required)
  • type (semantic|episodic|belief|goal, required)
  • importance (1-10, default 5)
  • tags (string array, optional)
• Behavior:
  • checks /health first
  • auto-tags if missing (working_question, decision heuristics)
  • commits are serialized (sequential) to protect local CPU embedding throughput
  • if server is unreachable, payload is queued to .memory_retry_queue.json
  • unreachable response is explicit:
    • Memory commit failed - server unreachable. Queued for retry.

3. memory_insights

• Purpose: surface pending background insights.
• Input:
  • limit (number, default 10)
• Behavior: checks /health first, calls /insights/pending, returns formatted insight list.

Reliability Guarantees

• Mandatory health gate before each tool call (GET /health).
• Retry queue flushes automatically on healthy tool calls and heartbeat.
• Heartbeat supports automatic retry recovery and background maintenance.

Session Arc Lifecycle Hooks

The v2.5 skill supports episodic session arc capture:

• checkpoint capture every 20 turns
• session-end capture during teardown/reset

Flow:

1. Extract recent conversation turns (up to 20).
2. Run summarization with prompt:
   • Summarize this session arc: What was the goal? What approaches were tried? What decisions were made? What remains open?
3. Persist summary through internal memory_commit as:
   • type: "episodic"
   • tags: ["session_arc", "YYYY-MM-DD"]

Passive Context Injection