Vanar Neutron Memory

Save and recall agent memory with semantic search. Context that persists across every session.

Neutron Memory

Every conversation, preference, and decision your agent makes can persist across sessions. Save what matters, and when you need it, semantic search finds the right context by meaning — not keywords. Every session builds on the last.

How It Works

Manual — save and search with simple commands:

1. ./scripts/neutron-memory.sh save "user prefers dark mode" "Preferences" — save context
2. ./scripts/neutron-memory.sh search "what theme does the user like" — find it by meaning

Automatic (opt-in) — enable hooks to capture and recall automatically:

1. Auto-Capture saves conversations after each AI turn
2. Auto-Recall finds relevant memories before each AI turn and injects them as context

Quick Start

See SETUP.md for the full setup guide. TL;DR:

1. Get a free API key at https://openclaw.vanarchain.com/ ($20 free credits, no credit card)
2. export API_KEY=nk_your_key
3. ./scripts/neutron-memory.sh test

Commands

Save

bash

./scripts/neutron-memory.sh save "Content to remember" "Title"

Search

bash

./scripts/neutron-memory.sh search "what do I know about X" 10 0.5

Arguments: QUERY LIMIT THRESHOLD(0-1)

Diagnose

bash

./scripts/neutron-memory.sh diagnose

Checks all prerequisites: curl, jq, API key, connectivity, and authentication.

Hooks (Auto-Capture & Auto-Recall)

• hooks/pre-tool-use.sh — Auto-Recall: Queries memories before AI turn, injects relevant context
• hooks/post-tool-use.sh — Auto-Capture: Saves conversation after AI turn

Both are disabled by default (opt-in only). To enable:

bash

export VANAR_AUTO_RECALL=true
export VANAR_AUTO_CAPTURE=true

API Endpoints

• POST /memory/save — Save text (multipart/form-data)
• POST /memory/search — Semantic search (JSON body)

Auth: Authorization: Bearer $API_KEY — that's it. No other credentials needed.

Security & Privacy

No data is sent unless you run a command or explicitly enable auto-capture/auto-recall. Both hooks are disabled by default.

This skill only sends data you explicitly save (or opt-in auto-captured conversations) to the Neutron API. Here's exactly what happens:

Action	What's sent	Where
Save	The text you pass to save or auto-captured conversation turns	POST /memory/save over HTTPS
Search	Your search query text	POST /memory/search over HTTPS
Auto-Recall	The user's latest message (used as search query)	POST /memory/search over HTTPS
Auto-Capture	User: {message}\nAssistant: {response}	POST /memory/save over HTTPS

What is NOT sent:

• No local files are read or uploaded
• No environment variables (other than the API key for auth)
• No system information, file paths, or directory contents
• No data from other tools or skills

All communication is over HTTPS to api-neutron.vanarchain.com. The source code is fully readable in the scripts/ and hooks/ directories — three short bash scripts, no compiled binaries.