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 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.

Vanar Neutron Memory

AI Skill Market Insights

Be Part of the 0+ Developer Community

Neutron Memory

How It Works

Quick Start

Commands

Save

Search

Diagnose

Hooks (Auto-Capture & Auto-Recall)

API Endpoints

Security & Privacy

Quick Start

Manual Installation

TEAR & SHARE

Tags

Multi-Agent Patterns

Memory Systems Design

Context Degradation Detection

Context Optimization

Tool Design for Agents

Channels

Learn

Compare

Company