memory-setup

# Memory Setup Skill Transform your agent from goldfish to elephant. This skill helps configure persistent memory for Moltbot/Clawdbot. ## Quick Setup ### 1. Enable Memory Search in Config Add to `~/.clawdbot/clawdbot.json` (or `moltbot.json`): ```json { "memorySearch": { "enabled": true, "provider": "voyage", "sources": ["memory", "sessions"], "indexMode": "hot", "minScore": 0.3, "maxResults": 20 } } ``` ### 2. Create Memory Structure In your workspace, create: ``` workspace/ ├── MEMORY.md # Long-term curated memory └── memory/ ├── logs/ # Daily logs (YYYY-MM-DD.md) ├── projects/ # Project-specific context ├── groups/ # Group chat context └── system/ # Preferences, setup notes ``` ### 3. Initialize MEMORY.md Create `MEMORY.md` in workspace root: ```markdown # MEMORY.md — Long-Term Memory ## About [User Name] - Key facts, preferences, context ## Active Projects - Project summaries and status ## Decisions & Lessons - Important choices made - Lessons learned ## Preferences - Communication style - Tools and workflows ``` ## Config Options Explained | Setting | Purpose | Recommended | |---------|---------|-------------| | `enabled` | Turn on memory search | `true` | | `provider` | Embedding provider | `"voyage"` | | `sources` | What to index | `["memory", "sessions"]` | | `indexMode` | When to index | `"hot"` (real-time) | | `minScore` | Relevance threshold | `0.3` (lower = more results) | | `maxResults` | Max snippets returned | `20` | ### Provider Options - `voyage` — Voyage AI embeddings (recommended) - `openai` — OpenAI embeddings - `local` — Local embeddings (no API needed) ### Source Options - `memory` — MEMORY.md + memory/*.md files - `sessions` — Past conversation transcripts - `both` — Full context (recommended) ## Daily Log Format Create `memory/logs/YYYY-MM-DD.md` daily: ```markdown # YYYY-MM-DD — Daily Log ## [Time] — [Event/Task] - What happened - Decisions made - Follow-ups needed ## [Time] — [Another Event] - Details ``` ## Agent Instructions (AGENTS.md) Add to your AGENTS.md for agent behavior: ```markdown ## Memory Recall Before answering questions about prior work, decisions, dates, people, preferences, or todos: 1. Run memory_search with relevant query 2. Use memory_get to pull specific lines if needed 3. If low confidence after search, say you checked ``` ## Troubleshooting ### Memory search not working? 1. Check `memorySearch.enabled: true` in config 2. Verify MEMORY.md exists in workspace root 3. Restart gateway: `clawdbot gateway restart` ### Results not relevant? - Lower `minScore` to `0.2` for more results - Increase `maxResults` to `30` - Check that memory files have meaningful content ### Provider errors? - Voyage: Set `VOYAGE_API_KEY` in environment - OpenAI: Set `OPENAI_API_KEY` in environment - Use `local` provider if no API keys available ## Verification Test memory is working: ``` User: "What do you remember about [past topic]?" Agent: [Should search memory and return relevant context] ``` If agent has no memory, config isn't applied. Restart gateway. ## Full Config Example ```json { "memorySearch": { "enabled": true, "provider": "voyage", "sources": ["memory", "sessions"], "indexMode": "hot", "minScore": 0.3, "maxResults": 20 }, "workspace": "/path/to/your/workspace" } ``` ## Why This Matters Without memory: - Agent forgets everything between sessions - Repeats questions, loses context - No continuity on projects With memory: - Recalls past conversations - Knows your preferences - Tracks project history - Builds relationship over time Goldfish → Elephant. 🐘