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.
1---2name: shodh-local3description: Local-first brain for OpenClaw. Offline, learns with use.4---5
6---
7name: shodh-local
8summary: Local-first cognitive memory for AI agents with semantic recall, GTD todos, and knowledge graph.
9description: 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.
10---
11
12# Shodh-Local (v0.1.74)
13
14Local-first brain for OpenClaw. Offline, learns with use.
15
16## Config (TOOLS.md)
17- **Binary**: `./shodh-memory-server` (or add to PATH)
18- **Server**: `localhost:3030`
19- **Data**: `./shodh-data`
20- **Key**: `<YOUR-API-KEY>` (X-API-Key, generate via shodh-memory-server)
21- **Manage**: `process` tool (session `amber-seaslug`)
22- **TUI**: `cd tools/shodh-memory && ./shodh-tui` (graph/activity)
23
24## Quick Use
25```
26KEY='<YOUR-API-KEY>'
27curl -s -X POST http://localhost:3030/api/remember \\
28-H "Content-Type: application/json" -H "X-API-Key: $KEY" \\
29-d '{"user_id": "henry", "content": "Test memory", "memory_type": "Learning", "tags": ["test"]}'
30```
31
32## Core Tools
33- **Remember**: `/api/remember` (types: Learning/Observation/Conversation/Task/Preference)
34- **Recall**: `/api/recall` (semantic) | `/api/recall/tags`
35- **Proactive**: `/api/proactive_context` (auto-relevant)
36- **Todos**: `/api/todos/add` | `/api/todos` | `/api/todos/complete`
37- **Projects**: `/api/projects/add` | `/api/projects`
38- **Summary**: `/api/context_summary`
39
40Full API: [reference/api.md](reference/api.md)
41
42## Best Practices
43- **User ID**: `henry` (main), `openclaw` (system), `task-XYZ` (sub-agents)
44- **Tags**: Always add for filtering (e.g. ["openclaw", "project-backend"])
45- **Before reply**: Recall recent context for continuity
46- **Heartbeat**: Check todos daily
47- **Maintenance**: Restart server weekly (`process kill amber-seaslug` + restart)
48
49Read [reference/examples.md](reference/examples.md) for OpenClaw patterns.
majiayu000