{"skill":{"slug":"vanar-neutron-memory","displayName":"Vanar Neutron Memory","summary":"Save and recall agent memory with semantic search. Context that persists across every session.","description":"---\nname: vanar-neutron-memory\ndescription: Save and recall agent memory with semantic search. Context that persists across every session.\nuser-invocable: true\nmetadata: {\"openclaw\": {\"emoji\": \"🧠\", \"requires\": {\"env\": [\"API_KEY\"]}, \"primaryEnv\": \"API_KEY\"}}\n---\n\n# Neutron Memory\n\nEvery 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.\n\n## How It Works\n\n**Manual** — save and search with simple commands:\n1. `./scripts/neutron-memory.sh save \"user prefers dark mode\" \"Preferences\"` — save context\n2. `./scripts/neutron-memory.sh search \"what theme does the user like\"` — find it by meaning\n\n**Automatic** (opt-in) — enable hooks to capture and recall automatically:\n1. **Auto-Capture** saves conversations after each AI turn\n2. **Auto-Recall** finds relevant memories before each AI turn and injects them as context\n\n## Quick Start\n\nSee **[SETUP.md](SETUP.md)** for the full setup guide. TL;DR:\n\n1. Get a free API key at **https://openclaw.vanarchain.com/** ($20 free credits, no credit card)\n2. `export API_KEY=nk_your_key`\n3. `./scripts/neutron-memory.sh test`\n\n## Commands\n\n### Save\n```bash\n./scripts/neutron-memory.sh save \"Content to remember\" \"Title\"\n```\n\n### Search\n```bash\n./scripts/neutron-memory.sh search \"what do I know about X\" 10 0.5\n```\n\nArguments: `QUERY` `LIMIT` `THRESHOLD(0-1)`\n\n### Diagnose\n```bash\n./scripts/neutron-memory.sh diagnose\n```\n\nChecks all prerequisites: curl, jq, API key, connectivity, and authentication.\n\n## Hooks (Auto-Capture & Auto-Recall)\n\n- `hooks/pre-tool-use.sh` — **Auto-Recall**: Queries memories before AI turn, injects relevant context\n- `hooks/post-tool-use.sh` — **Auto-Capture**: Saves conversation after AI turn\n\nBoth are **disabled by default** (opt-in only). To enable:\n\n```bash\nexport VANAR_AUTO_RECALL=true\nexport VANAR_AUTO_CAPTURE=true\n```\n\n## API Endpoints\n\n- `POST /memory/save` — Save text (multipart/form-data)\n- `POST /memory/search` — Semantic search (JSON body)\n\n**Auth:** `Authorization: Bearer $API_KEY` — that's it. No other credentials needed.\n\n## Security & Privacy\n\n**No data is sent unless you run a command or explicitly enable auto-capture/auto-recall.** Both hooks are disabled by default.\n\nThis skill only sends data you explicitly save (or opt-in auto-captured conversations) to the Neutron API. Here's exactly what happens:\n\n| Action | What's sent | Where |\n|--------|------------|-------|\n| **Save** | The text you pass to `save` or auto-captured conversation turns | `POST /memory/save` over HTTPS |\n| **Search** | Your search query text | `POST /memory/search` over HTTPS |\n| **Auto-Recall** | The user's latest message (used as search query) | `POST /memory/search` over HTTPS |\n| **Auto-Capture** | `User: {message}\\nAssistant: {response}` | `POST /memory/save` over HTTPS |\n\n**What is NOT sent:**\n- No local files are read or uploaded\n- No environment variables (other than the API key for auth)\n- No system information, file paths, or directory contents\n- No data from other tools or skills\n\nAll 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.\n","topics":["Agent Memory"],"tags":{"latest":"1.3.2"},"stats":{"comments":0,"downloads":2661,"installsAllTime":100,"installsCurrent":3,"stars":1,"versions":13},"createdAt":1770404531360,"updatedAt":1778486065752},"latestVersion":{"version":"1.3.2","createdAt":1772243534662,"changelog":"Updated skill description, fixed opening paragraph","license":null},"metadata":{"setup":[{"key":"API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"naeemmaliki036","userId":"s174knx86bdgph4vast35xxcbn8858xx","displayName":"Vanar Neutron","image":"https://avatars.githubusercontent.com/u/82518152?v=4"},"moderation":null}