CortexReach / memory-lancedb-pro
Enhanced LanceDB memory plugin for OpenClaw — Hybrid Retrieval (Vector + BM25), Cross-Encoder Rerank, Multi-Scope Isolation, Management CLI
View on GitHubAI Architecture Analysis
This repository is indexed by RepoMind. By analyzing CortexReach/memory-lancedb-pro in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler view🧠 memory-lancedb-pro · 🦞OpenClaw Plugin **AI Memory Assistant for OpenClaw Agents** *Give your AI agent a brain that actually remembers — across sessions, across agents, across time.* A LanceDB-backed OpenClaw memory plugin that stores preferences, decisions, and project context, then auto-recalls them in future sessions. English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Español | Deutsch | Italiano | Русский | Português (Brasil) --- Why memory-lancedb-pro? Most AI agents have amnesia. They forget everything the moment you start a new chat. **memory-lancedb-pro** is a production-grade long-term memory plugin for OpenClaw that turns your agent into an **AI Memory Assistant** — it automatically captures what matters, lets noise naturally fade, and retrieves the right memory at the right time. No manual tagging, no configuration headaches. Your AI Memory Assistant in Action **Without memory — every session starts from zero:** > **You:** "Use tabs for indentation, always add error handling." > *(next session)* > **You:** "I already told you — tabs, not spaces!" 😤 > *(next session)* > **You:** "...seriously, tabs. And error handling. Again." **With memory-lancedb-pro — your agent learns and remembers:** > **You:** "Use tabs for indentation, always add error handling." > *(next session — agent auto-recalls your preferences)* > **Agent:** *(silently applies tabs + error handling)* ✅ > **You:** "Why did we pick PostgreSQL over MongoDB last month?" > **Agent:** "Based on our discussion on Feb 12, the main reasons were..." ✅ That's the difference an **AI Memory Assistant** makes — it learns your style, recalls past decisions, and delivers personalized responses without you repeating yourself. What else can it do? | | What you get | |---|---| | **Auto-Capture** | Your agent learns from every conversation — no manual needed | | **Smart Extraction** | LLM-powered 6-category classification: profiles, preferences, entities, events, cases, patterns | | **Intelligent Forgetting** | Weibull decay model — important memories stay, noise naturally fades away | | **Hybrid Retrieval** | Vector + BM25 full-text search, fused with cross-encoder reranking | | **Context Injection** | Relevant memories automatically surface before each reply | | **Multi-Scope Isolation** | Per-agent, per-user, per-project memory boundaries | | **Any Provider** | OpenAI, Jina, Gemini, Ollama, or any OpenAI-compatible API | | **Full Toolkit** | CLI, backup, migration, upgrade, export/import — production-ready | --- Quick Start Option A: One-Click Install Script (Recommended) The community-maintained **setup script** handles install, upgrade, and repair in one command: > See Ecosystem below for the full list of scenarios the script covers and other community tools. Option B: Manual Install **Via OpenClaw CLI (recommended):** **Or via npm:** > If using npm, you will also need to add the plugin's install directory as an **absolute** path in in your . This is the most common setup issue. Add to your : **Why these defaults?** • + → your agent learns from every conversation automatically • → relevant memories are injected before each reply • → extraction triggers in normal two-turn chats • → avoids polluting retrieval with session summaries on day one Validate & restart: You should see: • • Done! Your agent now has long-term memory. More installation paths (existing users, upgrades) **Already using OpenClaw?** • Add the plugin with an **absolute** entry • Bind the memory slot: • Verify: **Upgrading from pre-v1.1.0?** See for behavior changes and upgrade rationale. Telegram Bot Quick Import (click to expand) If you are using OpenClaw's Telegram integration, the easiest way is to send an import command directly to the main Bot instead of manually editing config. Send this message: --- Ecosystem memory-lancedb-pro is the core plugin. The community has built tools around it to make setup and daily use even smoother: Setup Script — One-Click Install, Upgrade & Repair > **CortexReach/toolbox/memory-lancedb-pro-setup** Not just a simple installer — the script intelligently handles a wide range of real-world scenarios: | Your situation | What the script does | |---|---| | Never installed | Fresh download → install deps → pick config → write to openclaw.json → restart | | Installed via , stuck on old commit | Auto + to latest → reinstall deps → verify | | Config has invalid fields | Auto-detect via schema filter, remove unsupported fields | | Installed via | Skips git update, reminds you to run yourself | | CLI broken due to invalid config | Fallback: read workspace path directly from file | | instead of | Auto-detect plugin location from config or filesystem | | Already up to date | Run health checks only, no changes | Built-in provider presets: **Jina / DashScope / SiliconFlow / OpenAI / Ollama**, or bring your own OpenAI-compatible API. For full usage (including , , and more), see the setup script README. Claude Code / OpenClaw Skill — AI-Guided Configuration > **CortexReach/memory-lancedb-pro-skill** Install this skill and your AI agent (Claude Code or OpenClaw) gains deep knowledge of every feature in memory-lancedb-pro. Just say **"help me enable the best config"** and get: • **Guided 7-step configuration workflow** with 4 deployment plans: • Full Power (Jina + OpenAI) / Budget (free SiliconFlow reranker) / Simple (OpenAI only) / Fully Local (Ollama, zero API cost) • **All 9 MCP tools** used correctly: , , , , , , , , *(full toolset requires — the default Quick Start config exposes the 4 core tools)* • **Common pitfall avoidance**: workspace plugin enablement, default-false, jiti cache, env vars, scope isolation, and more **Install for Claude Code:** **Install for OpenClaw:** --- Video Tutorial > Full walkthrough: installation, configuration, and hybrid retrieval internals. **https://youtu.be/MtukF1C8epQ** **https://www.bilibili.com/video/BV1zUf2BGEgn/** --- Architecture > For a deep-…