{"_id":"@amentilabs/openclaw-zvec-memory","name":"@amentilabs/openclaw-zvec-memory","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.1":{"name":"@amentilabs/openclaw-zvec-memory","version":"0.2.1","type":"module","description":"Local-first vector memory with graph edges for OpenClaw — powered by zvec-memory","license":"MIT","author":{"name":"ereid7"},"repository":{"type":"git","url":"git+https://github.com/ereid7/zvec-memory.git","directory":"openclaw-plugin"},"homepage":"https://github.com/ereid7/zvec-memory/tree/main/openclaw-plugin","bugs":{"url":"https://github.com/ereid7/zvec-memory/issues"},"keywords":["openclaw","openclaw-plugin","memory","zvec","vector","graph","local-first","ai-agent"],"peerDependencies":{"openclaw":">=2026.1.29"},"dependencies":{"@sinclair/typebox":"0.34.47"},"openclaw":{"extensions":["./index.ts"]},"devDependencies":{"@types/node":"^25.2.3","typescript":"^5.9.3"},"_id":"@amentilabs/openclaw-zvec-memory@0.2.1","gitHead":"fae09dcae3e8940fa4a2333579513dfcf34bd7d4","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-XxwLELTgpKGdiMTAHcq+lGMTQL5rjhJxvT1nFEDZFG5xOAYk/gx7x+TzJcKISNHRQ64I5zFavCJtyIg3e2q+Gw==","shasum":"14e3ec93f364a5d4ae3bd611689343ff82dba3e1","tarball":"https://registry.npmjs.org/@amentilabs/openclaw-zvec-memory/-/openclaw-zvec-memory-0.2.1.tgz","fileCount":7,"unpackedSize":56987,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEzuPpJ8sSJDeLOEnZxqNWMQnOskRluQY5R4KYrYsDiYAiEA98ullMhvWkkVxRQukdvOwjOjKHlLNisrl89LS1JZybw="}]},"_npmUser":{"name":"ereid7","email":"evan@reids.us"},"directories":{},"maintainers":[{"name":"ereid7","email":"evan@reids.us"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/openclaw-zvec-memory_0.2.1_1771294244639_0.28598867974196196"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-17T02:10:44.413Z","0.2.1":"2026-02-17T02:10:44.800Z","modified":"2026-02-17T02:10:45.062Z"},"maintainers":[{"name":"ereid7","email":"evan@reids.us"}],"description":"Local-first vector memory with graph edges for OpenClaw — powered by zvec-memory","homepage":"https://github.com/ereid7/zvec-memory/tree/main/openclaw-plugin","keywords":["openclaw","openclaw-plugin","memory","zvec","vector","graph","local-first","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/ereid7/zvec-memory.git","directory":"openclaw-plugin"},"author":{"name":"ereid7"},"bugs":{"url":"https://github.com/ereid7/zvec-memory/issues"},"license":"MIT","readme":"# @amentilabs/openclaw-zvec-memory\n\nLocal-first vector memory with graph edges for [OpenClaw](https://github.com/openclaw/openclaw) agents, powered by [zvec-memory](https://github.com/ereid7/zvec-memory).\n\nYour agent gets persistent memory that lives on your machine. No cloud, no API keys, no data leaving your network. Memories are connected through similarity edges, so recalling one fact surfaces related context automatically.\n\n## How it works\n\n**Auto-Recall** — Before the agent responds, the plugin searches local memory for relevant context and injects it. Graph edges mean related memories come along for free.\n\n**Auto-Capture** — After the agent responds, the conversation is sent through fact extraction. Important information gets stored automatically with embeddings and graph edges.\n\nBoth run silently. No prompting needed.\n\n## Setup\n\n### 1. Install zvec-memory (Python)\n\n```bash\npip install zvec-memory[server]\n# or from source:\ncd zvec-memory && pip install -e \".[server]\"\n```\n\n### 2. Install the plugin\n\n```bash\nopenclaw plugins install @amentilabs/openclaw-zvec-memory\n```\n\n### 3. Configure\n\nAdd to your `openclaw.json`:\n\n```json\n{\n  \"plugins\": {\n    \"entries\": {\n      \"openclaw-zvec-memory\": {\n        \"enabled\": true,\n        \"config\": {}\n      }\n    }\n  }\n}\n```\n\nThat's it. The plugin auto-starts the Python server and connects.\n\n## Configuration\n\n| Key | Type | Default | Description |\n|---|---|---|---|\n| `serverUrl` | string | `http://localhost:8400` | zvec-memory server URL |\n| `autoStartServer` | boolean | `true` | Auto-start the Python server |\n| `pythonPath` | string | `python3` | Python binary path |\n| `venvPath` | string | — | Virtualenv path (uses its Python) |\n| `autoRecall` | boolean | `true` | Inject memories before each turn |\n| `autoCapture` | boolean | `true` | Extract facts after each turn |\n| `topK` | number | `5` | Max memories per recall |\n| `followEdges` | boolean | `true` | Use graph traversal for richer recall |\n| `maxHops` | number | `1` | Max graph hops |\n| `userId` | string | `default` | User ID (stored as source) |\n\n### Custom Python/venv example\n\n```json\n{\n  \"config\": {\n    \"autoStartServer\": true,\n    \"venvPath\": \"~/.venvs/zvec-memory\",\n    \"topK\": 10,\n    \"followEdges\": true\n  }\n}\n```\n\n### Connect to existing server\n\n```json\n{\n  \"config\": {\n    \"autoStartServer\": false,\n    \"serverUrl\": \"http://localhost:8400\"\n  }\n}\n```\n\n## Agent Tools\n\n| Tool | Description |\n|---|---|\n| `memory_search` | Search memories with vector similarity + optional graph traversal |\n| `memory_store` | Save a fact with type, importance, and tags |\n| `memory_get` | Retrieve a specific memory by ID |\n| `memory_list` | List stored memories (broad search) |\n| `memory_forget` | Delete by ID or search-and-delete |\n\n## CLI\n\n```bash\n# Search memories with graph traversal\nopenclaw zvec search \"what does the user prefer\"\n\n# Search without graph edges\nopenclaw zvec search \"preferences\" --no-graph\n\n# Memory and graph statistics\nopenclaw zvec stats\n\n# Export graph (JSON or DOT for visualization)\nopenclaw zvec graph-export\nopenclaw zvec graph-export --format dot | dot -Tpng -o graph.png\n```\n\n## Why zvec-memory?\n\n| Feature | zvec-memory | supermemory | mem0 (OSS) |\n|---|---|---|---|\n| Local-first | ✅ Everything on disk | ❌ Cloud API | ⚠️ Needs Qdrant + LLM API |\n| Graph edges | ✅ Similarity + typed edges | ❌ | ⚠️ Platform only |\n| Version chains | ✅ root_id/parent_id | ✅ parentMemoryId | ❌ |\n| Zero cloud deps | ✅ Ollama optional | ❌ Requires API key | ❌ Requires OpenAI |\n| Auto-forget | ✅ Temporal expiry | ✅ | ❌ |\n| Fact extraction | ✅ Ollama-based | ✅ Built-in | ✅ LLM-required |\n\n## Architecture\n\n```\n┌──────────────────┐     HTTP      ┌──────────────────┐\n│  OpenClaw Agent  │ ←──────────→  │  zvec-memory     │\n│  (TypeScript)    │   localhost    │  FastAPI server   │\n│                  │               │  (Python)         │\n│  • 5 tools       │               │  • Zvec vectors   │\n│  • auto-recall   │               │  • SQLite graph   │\n│  • auto-capture  │               │  • Ollama embed   │\n│  • CLI           │               │  • Fact extractor │\n└──────────────────┘               └──────────────────┘\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-cfe6f09077a3f92263165a47cc98d163"}