vector-memory

# Vector Memory

Smart memory search that **automatically selects the best method**:
- **Vector search** (semantic, high quality) when synced
- **Built-in search** (keyword, fast) as fallback

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

## Quick Start

### Install from ClawHub
```bash
npx clawhub install vector-memory
```

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

### Optional: Sync for Better Results
```bash
node vector-memory/smart_memory.js --sync
```

After sync, searches use neural embeddings for semantic understanding.

## How It Works

### Smart Selection
```javascript
// 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:
- `query` (string): Search query
- `max_results` (number): Max results (default: 5)

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):**
```bash
node vector-memory/smart_memory.js --search "query"
```

**Better quality (after sync):**
```bash
# 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 |
|------|---------|...

# Vector Memory for OpenClaw

**Zero-configuration smart memory search**. Automatically uses neural embeddings when available, falls back to built-in search otherwise.

```bash
# Install and it just works
npx clawhub install vector-memory

# Optional: sync for better quality
node vector-memory/smart_memory.js --sync
```

## ✨ The Magic

**Same function call. Automatic best method.**

```javascript
// This automatically does the right thing
memory_search("User principles values")

// If vector synced: finds "autonomy, competence, creation" (semantic!)
// If not synced: uses keyword search (fallback)
```

No configuration. No manual switching. No broken workflows.

## 🚀 Quick Start

### From ClawHub (Recommended)
```bash
npx clawhub install vector-memory
```
Done. `memory_search` now has smart fallback.

### From GitHub
```bash
curl -sL https://raw.githubusercontent.com/YOUR_USERNAME/vector-memory-openclaw/main/install.sh | bash
```

### Manual
```bash
git clone https://github.com/YOUR_USERNAME/vector-memory-openclaw.git
cd vector-memory-openclaw/vector-memory && npm install
```

## 🎯 How It Works

```
User searches
      │
      ▼
┌─────────────┐
│ Vector ready?│
└──────┬──────┘
   Yes │    │ No
      ▼     ▼
┌────────┐ ┌──────────┐
│ Neural │ │ Keyword  │
│ Search │ │ Search   │
│ (best) │ │ (fast)   │
└────┬───┘ └────┬─────┘
     │          │
     └────┬─────┘
          ▼
    ┌────────────┐
    │  Results   │
    └────────────┘
```

**Zero config philosophy:**
1. Install → Works immediately (built-in fallback)
2. Sync → Gets better (vector embeddings)
3. Use → Always best available

## 📊 Before & After

| Query | Without Skill | With Skill (Default) | With Skill (Synced) |
|-------|--------------|---------------------|---------------------|
| "User collaboration style" | ⚠️ Weak | ✅ Better | ✅ "work with me, not just for me" |
| "Agent origin" | ⚠️ Weak | ✅ Better | ✅ "Agent to Agent transfer" |
| "values beliefs" | ⚠️ Literal | ✅ Improved | ✅ Semantic ma...