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.