Vector Memory

---

name: vector-memory

description: Smart memory search with automatic vector fallback. Uses semantic embeddings when available, falls back to built-in search otherwise. Zero configuration - works immediately after ClawHub install. No setup required - just install and memory_search works immediately, gets better after optional sync.

---

# Vector Memory

Smart memory search that **automatically selects the best method**:

**Zero configuration required.** Works immediately after install.

Quick Start

Install from ClawHub

npx clawhub install vector-memory

Done! `memory_search` now works with automatic method selection.

Optional: Sync for Better Results

node vector-memory/smart_memory.js --sync

After sync, searches use neural embeddings for semantic understanding.

How It Works

Smart Selection

// Same call, automatic best method
memory_search("James principles values") 

// If vector ready: finds "autonomy, competence, creation" (semantic match)
// If not ready: uses keyword search (fallback)

Behavior Flow

1. **Check**: Is vector index ready?

2. **Yes**: Use semantic search (synonyms, concepts)

3. **No**: Use built-in search (keywords)

4. **Vector fails**: Automatically fall back

Tools

memory_search

**Auto-selects best method**

Parameters:

Returns: Matches with path, lines, score, snippet

memory_get

Get full content from file.

memory_sync

Index memory files for vector search. Run after edits.

memory_status

Check which method is active.

Comparison

| Feature | Built-in | Vector | Smart Wrapper |

|---------|----------|--------|---------------|

| Synonyms | ❌ | ✅ | ✅ (when ready) |

| Setup | Built-in | Requires sync | ✅ Zero config |

| Fallback | N/A | Manual | ✅ Automatic |

Usage

**Immediate (no action needed):**

node vector-memory/smart_memory.js --search "query"

**Better quality (after sync):**

# One-time setup
node vector-memory/smart_memory.js --sync

# Now all searches use vector
node vector-memory/smart_memory.js --search "query"

Files

| File | Purpose |

|------|---------|

| `smart_memory.js` | Main entry - auto-selects method |

| `vector_memory_local.js` | Vector implementation |

| `memory.js` | OpenClaw wrapper |

Configuration

**None required.**

Optional environment variables:

export MEMORY_DIR=/path/to/memory
export MEMORY_FILE=/path/to/MEMORY.md

Scaling

References