Skill: naeemmaliki036/vanar-neutron-memory (version 1.3.2)

--- 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": ["API_KEY"]}, "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](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 [REDACTED_SECRET]` 3. `./scripts/neutron-memory.sh test` ## Commands ### Save ```bash ./scripts/neutron-memory.sh save "Content to remember" "Title" ``` ### Search ```bash ./scripts/neutron-memory.sh search "what do I know about X" 10 0.5 ``` Arguments: `QUERY` `LIMIT` `THRESHOLD(0-1)` ### Diagnose ```bash ./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: ```bash 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.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)