← Back to Skills Marketplace
Rag Memory
by
Morten Bojer
· GitHub ↗
· v1.1.1
· MIT-0
148
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install rag-memory
Description
Vector memory search and RAG skill for OpenClaw. Provides vector_search tool backed by Qdrant, auto-syncs memory .md files and Postgres records via nomic-emb...
Usage Guidance
This skill appears to implement what it claims, but review these items before installing:
- Auto-injection: The plugin defaults to auto_inject=true and will automatically send (a slice of) user messages to your configured embedding endpoint and query Qdrant to prepend context. If you don't want that automatic network activity or potential data leakage, disable auto_inject in the plugin config.
- Embedding endpoint trust: EMBED_BASE_URL/EMBED_API_KEY are the primary credentials; memory text is sent there for embedding. Only point this at services you control/trust (self-hosted LiteLLM, local Ollama, etc.).
- Postgres credentials: POSTGRES_DSN gives DB access. Use a narrowly scoped, read-only account limited to the expected tables (memory_entries, daily_logs, tools, qdrant_sync_log). Do not give a full-admin DSN.
- Missing/undeclared runtime binary: The bundle contains Node.js plugin and several node scripts that call /usr/bin/node, but the declared required binaries list omits node. Ensure node is available on the host (and the correct version) or add it to the required binaries before installing.
- Systemd deployment: The provided deploy.sh copies files into /etc/systemd/system and enables timers — that requires sudo. Review the unit files (in systemd/) before running the deploy script.
- Config and secrets handling: The repo expects a gitignored config.env with secrets. Confirm config.env is not committed and rotate keys as needed. Verify QDRANT_COLLECTION_PREFIX and EMBED_API_KEY values are set intentionally.
- Audit third-party deps: package-lock.json includes many transitive packages (some named @anthropic, AWS libs, etc.). The plugin code itself does not call Anthropic/AWS APIs, but you may want to review node dependencies if you install the plugin into your runtime.
If these points are acceptable and you lock down POSTGRES_DSN and your embedding/Qdrant endpoints, the skill is coherent with its stated purpose. If any of the above raise concerns (automatic outbound data, broad DB access, missing runtime binaries), treat the install as higher risk or change the defaults (disable auto_inject, create a read-only DB user, host your own embedding/Qdrant).
Capability Analysis
Type: OpenClaw Skill
Name: rag-memory
Version: 1.1.1
The rag-memory skill bundle implements a standard Retrieval-Augmented Generation (RAG) system using Qdrant for vector storage and an OpenAI-compatible embedding endpoint. The bundle includes a Python synchronization script (sync_to_qdrant.py), systemd units for automation, and a Node.js plugin (plugin/index.js) that provides a vector_search tool and automatic context injection. The code is well-documented, transparent about data flow to user-configured endpoints (QDRANT_HOST, EMBED_BASE_URL), and contains no evidence of malicious intent, obfuscation, or unauthorized data exfiltration.
Capability Tags
Capability Assessment
Purpose & Capability
Name, description, code, and required env vars align: Qdrant + embedding endpoint + Postgres + local MEMORY_DIR are all expected for a RAG memory sync + vector-search plugin. QDRANT_* and EMBED_* variables and POSTGRES_DSN are appropriate for ingesting and querying memory and docs.
Instruction Scope
The plugin includes an automatic 'before_prompt_build' auto_inject hook (default true) that will embed parts of the user's last message and query the embedding/Qdrant services to prepend context to prompts — this causes routine outbound calls (user text sent to EMBED_BASE_URL and vectors/metadata stored at QDRANT_HOST) without an explicit user action. The sync script reads local memory .md files, skill doc .md files, and data from Postgres (memory_entries, daily_logs, tools). Those reads match the stated purpose but also mean the skill will access other skills' markdown docs and any files in MEMORY_DIR.
Install Mechanism
There is no remote download/install step in the registry spec — files are provided with the skill bundle. No external arbitrary URLs or archive extraction are used. The included systemd deploy script requires sudo to copy units, which is expected for installing timers/watchers but requires administrator action.
Credentials
Requested environment variables (QDRANT_HOST/API_KEY, EMBED_BASE_URL/API_KEY, QDRANT_COLLECTION_PREFIX, POSTGRES_DSN, MEMORY_DIR) are functionally justified. However, POSTGRES_DSN is high-sensitivity (database credential) and should be provided with a read-only account limited to the expected tables. EMBED_API_KEY is the primary credential (embedding endpoint receives user text). The skill will send memory text to the embedding endpoint and store vectors+metadata in Qdrant, so those endpoints must be trusted/self-hosted if you care about data leakage.
Persistence & Privilege
always is false and the skill does not request permanent system-wide privileges beyond installing optional systemd units and a plugin entry. The systemd deployment requires sudo but modifies only its own service files. The skill does not attempt to change other skills' configs programmatically (it asks the operator to update openclaw.json if tuning is changed).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install rag-memory - After installation, invoke the skill by name or use
/rag-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
Fix tool.execute handler, skip auto-inject for short messages, cap injected result size to 500 chars, remove personal URLs from docs
v1.1.0
ClaWHub compliance: not_for triggers, trust/privacy/security manifest, example files, MIT-0 license, systemd deploy.sh, embedding throttle
v1.0.0
Initial release of the rag-memory skill for OpenClaw.
- Adds a setup wizard for configuring vector memory search (Qdrant, Ollama, Postgres, memory directory).
- Replaces full memory file loading with efficient vector_search queries.
- Handles first-time setup, ongoing sync (systemd-based), resync requests, and fallback if Qdrant is down.
- Outlines clear operational and troubleshooting steps for reliable RAG integration.
- Requires curl, python3, and jq dependencies.
Metadata
Frequently Asked Questions
What is Rag Memory?
Vector memory search and RAG skill for OpenClaw. Provides vector_search tool backed by Qdrant, auto-syncs memory .md files and Postgres records via nomic-emb... It is an AI Agent Skill for Claude Code / OpenClaw, with 148 downloads so far.
How do I install Rag Memory?
Run "/install rag-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Rag Memory free?
Yes, Rag Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Rag Memory support?
Rag Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Rag Memory?
It is built and maintained by Morten Bojer (@mbojer); the current version is v1.1.1.
More Skills