← Back to Plugins
Tools

Lobstermind Memory

pnll1991 By pnll1991 👁 110 views ▲ 0 votes

Long-term memory plugin for OpenClaw with SQLite storage, semantic search, and Obsidian sync

GitHub

Install

npm install

#

Configuration Example

{
     "plugins": {
       "slots": {
         "memory": "paolo-memory-v2"
       },
       "entries": {
         "paolo-memory-v2": {
           "enabled": true,
           "config": {
             "enabled": true
           }
         }
       }
     }
   }

README

# 🦞 LobsterMind Memory

## Long-Term Memory Plugin for OpenClaw

> **The memory plugin that ACTUALLY works** — 298 lines, 1 command install, zero config  
> **El plugin de memoria que REALMENTE funciona** — 298 líneas, 1 comando, cero config

[![GitHub stars](https://img.shields.io/github/stars/pnll1991/lobstermind-memory?style=for-the-badge)](https://github.com/pnll1991/lobstermind-memory/stargazers)
[![GitHub license](https://img.shields.io/github/license/pnll1991/lobstermind-memory?style=for-the-badge)](https://github.com/pnll1991/lobstermind-memory/blob/main/LICENSE)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.3.7+-blue?style=for-the-badge)](https://github.com/openclaw/openclaw)
[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=for-the-badge)](https://github.com/pnll1991/lobstermind-memory)

| vs Gigabrain | LobsterMind |
|--------------|-------------|
| Lines of Code | **298** vs 2000+ |
| Install Time | **1 min** vs 30+ min |
| Dependencies | **1** vs 3+ |
| Config Options | **0** vs 50+ |

---

**Author:** Paolozky  
**Version:** 1.0.0  
**License:** MIT  
**Compatible with:** OpenClaw 2026.3.7+

---

## 🌟 Overview | Descripción General

**English:**  
LobsterMind Memory is a fully functional long-term memory plugin for OpenClaw that enables your AI assistant to remember conversations, facts, and preferences across sessions. Unlike other memory plugins (like Gigabrain with 2000+ lines, Python dependencies, and complex setup), LobsterMind actually works out of the box with proper SQLite storage, semantic search via embeddings, and automatic Obsidian sync. **One command to install, zero config, just works.**

**Español:**  
LobsterMind Memory es un plugin de memoria a largo plazo totalmente funcional para OpenClaw que permite a tu asistente de IA recordar conversaciones, hechos y preferencias entre sesiones. A diferencia de otros plugins de memoria (como Gigabrain con 2000+ líneas, dependencias de Python, y setup complejo), LobsterMind funciona correctamente desde el inicio con almacenamiento SQLite, búsqueda semántica mediante embeddings, y sincronización automática con Obsidian. **Un comando para instalar, cero configuración, simplemente funciona.**

---

## ✨ Features | Características

### English

- **SQLite Storage**: All memories stored locally in a lightweight SQLite database
- **Semantic Search**: Find relevant memories using natural language queries powered by local hash-based embeddings
- **Local Embeddings**: No API keys required! Uses deterministic hash-based vectors for similarity search
- **Obsidian Sync**: Automatic export of memories to your Obsidian vault in Markdown format
- **CLI Commands**: Manage memories via command line (`--list`, `--add`, `--search`)
- **Auto-Capture**: Automatically captures memories from `<memory_note>` tags in conversations
- **Recall Hooks**: Injects relevant memories before each AI response
- **Zero Configuration**: Works immediately after installation - no API keys, no setup

### Español

- **Almacenamiento SQLite**: Todas las memorias guardadas localmente en una base de datos SQLite ligera
- **Búsqueda Semántica**: Encuentra memorias relevantes usando consultas en lenguaje natural con embeddings locales basados en hash
- **Embeddings Locales**: ¡No requiere API keys! Usa vectores determinísticos basados en hash para búsqueda por similitud
- **Sync con Obsidian**: Exportación automática de memorias a tu vault de Obsidian en formato Markdown
- **Comandos CLI**: Gestiona memorias vía línea de comandos (`--list`, `--add`, `--search`)
- **Captura Automática**: Captura memorias automáticamente desde tags `<memory_note>` en conversaciones
- **Hooks de Recall**: Inyecta memorias relevantes antes de cada respuesta de la IA
- **Cero Configuración**: Funciona inmediatamente después de la instalación - sin API keys, sin setup

---

## ⚡ LobsterMind vs Gigabrain - Comparación Directa

### Nota Importante | Important Note

**English:**  
Both LobsterMind and Gigabrain aim to solve long-term memory for OpenClaw. This comparison is meant to help you choose the right tool for your needs — not to diminish either project. Gigabrain has an ambitious vision and comprehensive feature set. LobsterMind prioritizes simplicity and immediate usability.

**Español:**  
Tanto LobsterMind como Gigabrain buscan resolver la memoria a largo plazo para OpenClaw. Esta comparación tiene como objetivo ayudarte a elegir la herramienta adecuada para tus necesidades, no disminuir ninguno de los proyectos. Gigabrain tiene una visión ambiciosa y un conjunto completo de funciones. LobsterMind prioriza la simplicidad y usabilidad inmediata.

### Tabla Rápida

| Característica | **LobsterMind** | **Gigabrain** |
|----------------|-----------------|---------------|
| **Líneas de código** | 298 (1 archivo) | 2000+ (50+ archivos) |
| **Instalación** | 1 comando | Wizard complejo + config |
| **Dependencias** | Node.js 22+ | Node.js + Python + Ollama |
| **Configuración** | Cero configuración | 50+ opciones JSON |
| **Obsidian** | 1 archivo `Memories.md` | 40+ carpetas y vistas |
| **CLI** | 3 comandos simples | 20+ subcomandos complejos |
| **Embeddings** | API + fallback hash | Ollama local (modelo 9B+) |
| **Windows** | ✅ Nativo | ⚠️ Problemático |
| **Mantenimiento** | Ninguno | Nightly pipeline + audits |
| **Tamaño download** | ~50 KB | ~5 MB+ |

### Comparación Detallada

#### 🎯 Filosofía de Diseño | Design Philosophy

**LobsterMind:**
> "Hagamos algo que funcione, sea simple, y cualquier persona pueda instalar en 1 minuto"
>
> "Let's make something that works, is simple, and anyone can install in 1 minute"

**Gigabrain:**
> "Construyamos el sistema de memoria más completo y académico, con todos los features imaginables, aunque requiera configuración avanzada"
>
> "Let's build the most comprehensive and academic memory system, with every imaginable feature, even if it requires advanced configuration"

**Ambos son válidos. Depende de lo que necesitás.** | **Both are valid. Depends on what you need.**

#### 📦 Complejidad

**Gigabrain requiere:**
- ❌ Python 3.10+ además de Node.js
- ❌ Ollama con modelos de 9B+ (4GB+ RAM)
- ❌ FastAPI para web console
- ❌ Entender "memoria híbrida", "registry projections", "native sync"
- ❌ Configurar 50+ opciones en JSON
- ❌ Ejecutar nightly pipelines, audits, snapshots

**LobsterMind requiere:**
- ✅ Node.js 22+
- ✅ 1 comando de instalación
- ✅ Usar

#### 🔧 Obsidian

**Gigabrain genera:**
```
obsidian-vault/Gigabrain/
├── 00 Home/
├── 10 Native/
├── 20 Nodes/active/
├── 20 Nodes/archived/
├── 30 Views/ (6+ archivos)
├── 40 Reports/ (4+ archivos)
└── Inbox/
```

**LobsterMind genera:**
```
obsidian-vault/Gigabrain/
└── Memories.md  ← Un solo archivo limpio
```

#### 🧠 Embeddings

**Gigabrain:**
1. Instala Ollama
2. Descarga modelo `qwen3.5:9b` (4GB+)
3. Configura embeddings locales
4. Si Ollama falla → no hay búsqueda semántica

**LobsterMind:**
1. DashScope API (sin downloads)
2. Si API falla → fallback hash automático
3. Siempre funciona

#### 💻 CLI

**Gigabrain:**
```bash
node scripts/gigabrainctl.js nightly --config ~/.openclaw/openclaw.json
node scripts/gigabrainctl.js vault build --skip-reports
node scripts/gigabrainctl.js audit --mode apply --threshold 0.78
```

**LobsterMind:**
```bash
openclaw memories --list
openclaw memories --add "Tu memoria"
openclaw memories --search "búsqueda"
```

### 📊 ¿Cuál Elegir? | Which to Choose?

| Si querés... | If you want... | Elegí... | Choose... |
|--------------|----------------|----------|-----------|
| Investigar sistemas de memoria | Research memory systems | Gigabrain | Gigabrain |
| Arquitectura compleja académica | Academic complex architecture | Gigabrain | Gigabrain |
| Control total de cada setting | Full control of every setting | Gigabrain | Gigabrain |
| Features avanzados (audit, entity graph, web console) | Advanced features | Gigabrain | Gigabrain |
| **Que funcione YA** | **That works NOW** | **LobsterMind** | **LobsterMind** |
| **Instalar en 1 minuto** | **Install in 1 minute** | **LobsterMind** | **LobsterMind** |
| **Entender tu plugin** | **Understand your plugin** | **LobsterMind** | **LobsterMind** |
| **Windows sin dolor** | **Windows without pain** | **LobsterMind** | **LobsterMind** |
| **Sin Python/Ollama** | **No Python/Ollama** | **LobsterMind** | **LobsterMind** |
| **Simplicidad** | **Simplicity** | **LobsterMind** | **LobsterMind** |
| **95% de casos con 10% complejidad** | **95% use cases with 10% complexity** | **LobsterMind** | **LobsterMind** |

### 💬 Para los Escépticos | For the Skeptics

> "Pero Gigabrain tiene más features..."
>
> "But Gigabrain has more features..."

**Respuesta | Answer:** ¿Cuántas usás realmente? | How many do you actually use?

**Gigabrain incluye:**
- Web console (FastAPI dashboard)
- Benchmarking harness
- Nightly audit pipeline
- Entity relationship graph
- Memory compression/archiving
- Vault mirroring with dual-surface
- Review queues
- Metrics reports

**¿Necesitás todo eso para memoria personal?** | **Do you need all that for personal memory?**

Probablemente no. | Probably not.

**LobsterMind tiene lo que importa:**
- ✅ Guardar memorias | Save memories
- ✅ Buscar memorias | Search memories
- ✅ Ver memorias | View memories
- ✅ Sync con Obsidian | Obsidian sync
- ✅ Funciona siempre | Works always

**Si después necesitás features avanzados, migrá a Gigabrain.** | **If you later need advanced features, migrate to Gigabrain.**

---

## 🔧 Why LobsterMind Works (When Others Don't) | ¿Por qué LobsterMind Funciona?

### English

**The Problem with Gigabrain and Similar Plugins:**

Many memory plugins for OpenClaw (like [Gigabrain](https://github.com/legendaryvibecoder/gigabrain)) have conceptual designs but fail in practice because:

1. ❌ **Broken Plugin API Usage**: They use outdated or incorrect OpenClaw plugin registration patterns
2. ❌ **Missing Dependencies**: Don't properly bundle or i

... (truncated)
tools

Comments

Sign in to leave a comment

Loading comments...