← Back to Skills Marketplace
131
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install zouroboros-memory
Description
Production-grade persistent memory for AI agents. Hybrid SQLite + vector search, decay classes, episodic memory, cognitive profiles, and MCP server.
Usage Guidance
This skill appears to implement what it claims: a local hybrid SQLite + vector memory with CLI and an MCP server. Before installing, consider:
- If you enable vector search or reranking, the skill will send text to external services (OLLAMA_URL or OpenAI). Only set these env vars if you trust the destination (prefer a local Ollama instance).
- The package writes a database by default to ~/.zouroboros/memory.db — pick and review the DB path if you don't want persistent data in your home directory.
- The npm package depends on better-sqlite3 (native addon) which compiles on install — review/build in a controlled environment if you have supply-chain concerns.
- Registry metadata did not declare env vars or the config path; this is likely an oversight. Verify the upstream repository and package integrity (check GitHub releases, package contents, and package checksum) before installing into a production agent.
- For minimal risk, run the package in a sandboxed environment, avoid setting OPENAI_API_KEY or OLLAMA_URL to public endpoints, and audit network activity the first time the skill runs.
Capability Analysis
Type: OpenClaw Skill
Name: zouroboros-memory
Version: 3.0.0
The zouroboros-memory skill bundle is a legitimate implementation of a persistent memory system for AI agents, providing hybrid keyword and vector search capabilities. It uses SQLite (via better-sqlite3) for local storage and integrates with Ollama or OpenAI for embeddings and reranking. The code follows standard patterns for MCP (Model Context Protocol) servers, including secure parameter binding for SQL queries and standard JSON-RPC communication over stdio. No evidence of data exfiltration, malicious execution, or prompt injection was found across the source files (e.g., src/database.ts, src/mcp-server.ts) or documentation.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description align with the code and files: a Node.js package that provides persistent memory (SQLite schema, embeddings, episodic memory, graph, MCP server, CLI). Required binary (node) and npm install are appropriate for this functionality.
Instruction Scope
SKILL.md and README show normal, scoped runtime instructions (npx CLI, start MCP server, init DB, store/search facts). The runtime code will call external services only when vectorEnabled or reranker features are enabled (calls to Ollama endpoints and OpenAI API). The skill also reads/writes a local DB path (~/.zouroboros/memory.db) and can read files for batch import — these are expected for a persistent memory tool but should be noted.
Install Mechanism
Install spec is an npm package (zouroboros-memory) that creates two binaries — expected. It depends on better-sqlite3 (native addon compiled on install), which raises the usual native-build/supply-chain considerations but is proportionate to embedding a local SQLite storage engine.
Credentials
Registry metadata declared no required env vars, but the code/README use several optional env vars (ZO_MEMORY_DB / ZOUROBOROS_MEMORY_DB, OLLAMA_URL, OLLAMA_MODEL, OPENAI_API_KEY, ZO_OPENAI_API_KEY). Those are functionally justified (DB override, enabling embeddings via Ollama, enabling OpenAI reranker) but the metadata omission is an inconsistency. Enabling vector or reranker features will send content to external endpoints (ollama host or api.openai.com), which can leak sensitive data if unintentionally enabled.
Persistence & Privilege
always:false (normal). The package will create and persist a database under the user's file system (default ~/.zouroboros/memory.db) and write migration tables, indices, and embeddings; this is expected and required for a memory skill but is a persistent local footprint the user should accept explicitly.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zouroboros-memory - After installation, invoke the skill by name or use
/zouroboros-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
Initial ClawHub release. Production-grade persistent memory with hybrid SQLite + vector search, decay classes, episodic recall, cognitive profiles, and MCP server.
Metadata
Frequently Asked Questions
What is Zouroboros Memory?
Production-grade persistent memory for AI agents. Hybrid SQLite + vector search, decay classes, episodic memory, cognitive profiles, and MCP server. It is an AI Agent Skill for Claude Code / OpenClaw, with 131 downloads so far.
How do I install Zouroboros Memory?
Run "/install zouroboros-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Zouroboros Memory free?
Yes, Zouroboros Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Zouroboros Memory support?
Zouroboros Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Zouroboros Memory?
It is built and maintained by marlandoj (@marlandoj); the current version is v3.0.0.
More Skills