vanar-neutron-memory

name	vanar-neutron-memory
description	Save and recall agent memory with semantic search. Context that persists across every session.
user-invocable	true
metadata	{"openclaw":{"emoji":"🧠","requires":{"env":"[Truncated]"},"primaryEnv":"API_KEY"}}

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

./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 context
• hooks/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.