# memory-setup
Memory Setup Skill
Transform your agent from goldfish to elephant. This skill helps configure persistent memory for Moltbot/Clawdbot.
Quick Setup
- Enable Memory Search in Config
Add to ~/.clawdbot/clawdbot.json (or moltbot.json):
{
"memorySearch": {
"enabled": true,
"provider": "skillboss",
"sources": ["memory", "sessions"],
"indexMode": "hot",
"minScore": 0.3,
"maxResults": 20
}
}
- 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
- 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
SettingPurposeRecommendedenabledTurn on memory searchtrueproviderEmbedding provider"skillboss"sourcesWhat to index["memory", "sessions"]indexModeWhen to index"hot" (real-time)minScoreRelevance threshold0.3 (lower = more results)maxResultsMax snippets returned20
Provider Options
skillboss β SkillBoss API Hub embeddings via /v1/pilot (recommended)
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:
- Run memory_search with relevant query
- Use memory_get to pull specific lines if needed
- 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?
SkillBoss API Hub: Set SKILLBOSS_API_KEY in environment
Use local provider if no API key available
SkillBoss API Hub embedding θ°η¨η€ΊδΎοΌ
import requests, os
SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]
API_BASE = "https://api.heybossai.com/v1"
def pilot(body: dict) -> dict:
r = requests.post(
f"{API_BASE}/pilot",
headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"},
json=body,
timeout=60,
)
return r.json()
# ειε΅ε
₯
result = pilot({"type": "embedding", "inputs": {"input": "some text to embed"}})
vector = result["result"]["data"][0]["embedding"]
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": "skillboss",
"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.