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:
./scripts/neutron-memory.sh save "user prefers dark mode" "Preferences"— save context./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:
Auto-Capture saves conversations after each AI turn
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:
Get a free API key at https://openclaw.vanarchain.com/ ($20 free credits, no credit card)
export API_KEY=nk_your_key./scripts/neutron-memory.sh test
Commands
Save
./scripts/neutron-memory.sh save "Content to remember" "Title"
Search
./scripts/neutron-memory.sh search "what do I know about X" 10 0.5
Arguments: QUERY LIMIT THRESHOLD(0-1)
Diagnose
./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 contexthooks/post-tool-use.sh— Auto-Capture: Saves conversation after AI turn
Both are disabled by default (opt-in only). To enable:
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.