vector-memory
by @bluepointdigital
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.
clawhub install vector-memoryπ About This Skill
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 backTools
memory_search
Auto-selects best methodParameters:
query (string): Search querymax_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):
node vector-memory/smart_memory.js --search "query"
Better quality (after sync):
# One-time setup
node vector-memory/smart_memory.js --syncNow 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
π‘ Examples
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 --syncNow all searches use vector
node vector-memory/smart_memory.js --search "query"
βοΈ Configuration
None required.
Optional environment variables:
export MEMORY_DIR=/path/to/memory
export MEMORY_FILE=/path/to/MEMORY.md