Hybrid Memory System

We use two memory systems integrated into a single view:

1. QMD (Vector Store): For retrieving documents, specs, and full content.
2. Graphiti (Knowledge Graph): For retrieving facts, timelines, and relationships.

Primary Tool

For 95% of memory queries, use the hybrid search script. It queries both systems in parallel.

~/.openclaw/scripts/memory-hybrid-search.sh "your query"

Optional flags:

• [group_id] — Specify agent group (default: openclaw-main)
• --json — Output JSON for programmatic use

Specific Tools (Advanced)

Only use these if the hybrid script fails or you need granular control.

Graphiti Only (Temporal/Facts)

Search for specific temporal facts:

~/.openclaw/scripts/graphiti-search.sh "your question" openclaw-main 10

Log new facts (IMPORTANT):

~/.openclaw/scripts/graphiti-log.sh openclaw-main user "Name" "Fact to remember"

QMD Only (Deep Document Search)

If you need more results or specific file filtering:

qmd search "query" -n 10

Recall Pattern

1. User asks question ("What was the plan for the project?")
2. Run Hybrid Search (~/.openclaw/scripts/memory-hybrid-search.sh "plan for the project")
3. Synthesize Answer from both the temporal facts and document snippets found.
4. If needed: Use read to get the full content of a file found in the QMD results.

When to Use Which

Question Type	Use
"What's in GOALS.md?"	Hybrid search → read file
"When did we discuss X?"	Hybrid search (Graphiti results)
"What did I say last Tuesday?"	Graphiti direct
"Find notes about architecture"	Hybrid search (QMD results)