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):
{
"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:
# 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:
# 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:
## 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?
- Check memorySearch.enabled: true in config
- Verify MEMORY.md exists in workspace root
- 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
{
"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. 🐘
