name: shodh-local
summary: Local-first cognitive memory for AI agents with semantic recall, GTD todos, and knowledge graph.
description: Local Shodh-Memory v0.1.74 (offline cognitive memory for AI agents). Use for persistent remembering, semantic recall, GTD todos/projects, knowledge graph. Triggers: "remember/save/merke X", "recall/Erinnere/search memories about Y", "todos/add/complete", "projects", "proactive context", "what learned about Z". Server localhost:3030 (amber-seaslug), key in TOOLS.md. Hebbian learning, 3-tier (working/session/LTM), TUI dashboard.
Shodh-Local (v0.1.74)
Local-first brain for OpenClaw. Offline, learns with use.
Config (TOOLS.md)
- Binary:
./shodh-memory-server (or add to PATH)
- Server:
localhost:3030
- Data:
./shodh-data
- Key:
<YOUR-API-KEY> (X-API-Key, generate via shodh-memory-server)
- Manage:
process tool (session amber-seaslug)
- TUI:
cd tools/shodh-memory && ./shodh-tui (graph/activity)
Quick Use
KEY='<YOUR-API-KEY>'
curl -s -X POST http://localhost:3030/api/remember \\
-H "Content-Type: application/json" -H "X-API-Key: $KEY" \\
-d '{"user_id": "henry", "content": "Test memory", "memory_type": "Learning", "tags": ["test"]}'
Core Tools
- Remember:
/api/remember (types: Learning/Observation/Conversation/Task/Preference)
- Recall:
/api/recall (semantic) | /api/recall/tags
- Proactive:
/api/proactive_context (auto-relevant)
- Todos:
/api/todos/add | /api/todos | /api/todos/complete
- Projects:
/api/projects/add | /api/projects
- Summary:
/api/context_summary
Full API: reference/api.md
Best Practices
- User ID:
henry (main), openclaw (system), task-XYZ (sub-agents)
- Tags: Always add for filtering (e.g. ["openclaw", "project-backend"])
- Before reply: Recall recent context for continuity
- Heartbeat: Check todos daily
- Maintenance: Restart server weekly (
process kill amber-seaslug + restart)
Read reference/examples.md for OpenClaw patterns.
