hybrid-memory

# 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. ```bash ~/.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: ```bash ~/.openclaw/scripts/graphiti-search.sh "your question" openclaw-main 10 ``` Log new facts (IMPORTANT): ```bash ~/.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: ```bash 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) |