Overkill Memory System

# Ensure Python 3.8+ is available
python3 --version
Optional: ChromaDB for semantic search
pip install chromadb
Optional: Ollama for embeddings
Install from https://github.com/ollama/ollama

Step 1: Install the Skill

# The skill should be placed in your skills directory
~/.openclaw/workspace/skills/overkill-memory-system/

Step 2: Configure Environment

Copy .env.example to .env and configure:

cp .env.example .env
Edit .env with your preferences

Step 3: Initialize Memory System

python3 cli.py init

This creates all required memory files:

Memory System Won't Initialize

# Check directory permissions
ls -la ~/.openclaw/memory/
Manually create directory
mkdir -p ~/.openclaw/memory

ChromaDB Connection Failed

# Check if ChromaDB is running
curl http://localhost:8100/api/v1/heartbeat
Or use keyword search fallback
python3 cli.py search "query" --method keyword

Ollama Embeddings Not Working

# Check Ollama is running
curl http://localhost:11434/api/tags
Verify embedding model
ollama list

Session State Not Persisting

# Manually flush WAL buffer
python3 cli.py session end
Check session file
cat ~/.openclaw/memory/SESSION-STATE.md

Memory Search Returns No Results

# Rebuild search index
python3 cli.py analyze
Try keyword fallback
python3 cli.py search "term" --method keyword

Git-Notes Sync Issues

# Check git-notes directory
ls -la ~/.openclaw/memory/git-notes/
Initialize git repo if needed
cd ~/.openclaw/memory/git-notes && git init