hybrid-memory

Hybrid Memory System

Two memory systems, each with different strengths. Use both.

When to Use Which

Question Type	Tool	Example
Document content	memory_search	"What's in GOALS.md?"
Curated notes	memory_search	"What are our project guidelines?"
Temporal facts	Graphiti	"When did we set up Slack?"
Conversations	Graphiti	"What did the user say last Tuesday?"
Entity tracking	Graphiti	"What projects involve Alice?"

Quick Reference

memory_search (Built-in)

Semantic search over markdown files (MEMORY.md, memory/**/*.md).

memory_search query="your question"

Then use memory_get to read specific lines if needed.

Graphiti (Temporal)

Search for facts with time awareness:

graphiti-search.sh "your question" GROUP_ID 10

Log important facts:

graphiti-log.sh GROUP_ID user "Name" "Fact to remember"

Common group IDs:

• main-agent — Primary agent
• user-personal — User's personal context

Recall Pattern

When answering questions about past context:

1. Temporal questions → Check Graphiti first
2. Document questions → Use memory_search
3. Uncertain → Try both, combine results
4. Low confidence → Say you checked but aren't sure

AGENTS.md Template

Add to your AGENTS.md:

### Memory Recall (Hybrid)

**Temporal questions** ("when?", "what changed?", "last Tuesday"):
```bash
graphiti-search.sh "query" main-agent 10

Document questions ("what's in X?", "find notes about Y"):

memory_search query="your query"

When answering past context: check Graphiti for temporal, memory_search for docs.

## Setup

Full setup guide: https://github.com/clawdbrunner/openclaw-graphiti-memory

**Part 1: OpenClaw Memory** — Configure embedding provider (Gemini recommended)
**Part 2: Graphiti** — Deploy Docker stack, install sync daemons