Arshis-Memory-Pro v5.0.0

OpenClaw Primary Memory Plugin for indie developers and power users. Manages long-term memory with vector search, self-evolution, dreaming engine, and strict context injection control.

Modes

Primary Mode (default)

• Takes over OpenClaw memory slot
• Replaces memory-core as the primary memory provider
• Uses Arshis Dreaming Engine instead of native dreaming
• Full control over memory injection and context limits

Helper Mode

• Does not occupy the memory slot
• Coexists with OpenClaw memory-core
• Acts as auxiliary retrieval and scoring system
• Does not interfere with native memory operations

Core Features

Memory Storage and Retrieval

• LanceDB vector database (1024-dimensional semantic vectors)
• Hybrid retrieval: vector semantics + BM25 keywords + rerank reordering
• Auto-grading by importance (0.1-1.0): core/working/peripheral
• Self-evolution engine adapts retrieval weights based on feedback

Arshis Dreaming Engine v1.0

• Light Sleep (30 min): Summarize recent conversations and short-term memories
• Deep Sleep (120 min): Distill long-term patterns and themes
• REM Dream (360 min): Generate creative cross-category connections
• Forgetting (30 day decay): Archive low-value, old memories
• Promotion: Promote high-value, frequently-recalled memories to long-term

Context Injection Control

• Default: summary-only mode (not full memory text)
• Maximum 8 memories injected per query (configurable)
• Relevance threshold filtering (default: 0.72)
• Max context token limit for memory (default: 12,000)
• Low-relevance memories excluded from injection
• Prevents context explosion from memory overload

Self-Evolution

• Automatic feedback collection on every retrieval
• Parameter auto-optimization (weights, decay cycles, thresholds)
• Strategy generation from error patterns
• Architectural reflection: detects systemic issues and reports

Privacy and Safety

• No external network requests
• No data collection or upload
• No external LLM calls
• No API keys required
• Local storage only
• Auto-capture disabled by default
• User confirmation required for destructive operations
• Clear, export, and delete commands available

Usage

Store Memory

store_memory({ text: "The five races are Human, Fox, Feather, Spirit, and Stone.", importance: 0.9, category: "worldview" })

Recall Memory

recall_memory({ query: "five races", limit: 5 })

Delete Memory

delete_memory({ memory_id: "abc123..." })

Memory Statistics

memory_stats()

Dream Cycles

run_dream_cycle({ mode: "light" })    // Summarize recent
run_dream_cycle({ mode: "deep" })     // Distill patterns
run_dream_cycle({ mode: "rem" })      // Creative connections
run_dream_cycle({ mode: "forgetting" }) // Archive old memories
run_dream_cycle({ mode: "promotion" }) // Promote to long-term

Evolution

evolution_status()
evolution_report()

Privacy Controls

export_memories({ filepath: "/path/to/backup.json" })
clear_memories({ confirm: true })

Plugin Info

get_plugin_info()

Configuration (Environment Variables)

Data Location

All memory data stored in: ~/.openclaw/data/memory-custom/

• memories.json: Memory database (JSON fallback)
• memories.lance: Vector database (LanceDB)
• evolution/: Self-evolution data
• dreams/: Dream logs

Dream logs stored in: ~/.openclaw/workspace/memory/arshis-dreams/

Privacy Statement

This plugin:

• Does NOT make outbound network requests
• Does NOT collect or upload user data
• Does NOT call external LLM services
• Does NOT require API keys
• Stores ALL data locally
• Does NOT replace OpenClaw memory slot unless primary mode is explicitly enabled

Requirements

• OpenClaw 2026.4.0+
• Python 3.9+
• LanceDB 0.26+ (for vector storage)
• rank-bm25 0.2.0+ (for keyword search)

License

MIT-0