名称： shodh-local
摘要： 面向 AI 代理的本地优先认知记忆系统，具备语义回忆、GTD 待办事项和知识图谱功能。
描述： Shodh-Memory 本地版 v0.1.74（AI 代理的离线认知记忆）。用于持久记忆、语义回忆、GTD 待办事项/项目和知识图谱。触发词："记住/保存/记录 X"、"回忆/搜索关于 Y 的记忆"、"待办事项/添加/完成"、"项目"、"主动上下文"、"关于 Z 学到了什么"。服务器运行于 localhost:3030（会话标识 amber-seaslug），密钥在 TOOLS.md 中。采用赫布学习机制，三层记忆结构（工作记忆/会话记忆/长时记忆），提供 TUI 仪表盘。

Shodh-Local (v0.1.74)

OpenClaw 的本地优先大脑。离线运行，在使用中学习。

配置 (TOOLS.md)

• 可执行文件: ./shodh-memory-server（或添加到 PATH 环境变量）
• 服务器地址: localhost:3030
• 数据目录: ./shodh-data
• API 密钥: <YOUR-API-KEY>（通过 X-API-Key 头传递，可通过 shodh-memory-server 生成）
• 进程管理: 使用 process 工具（会话标识为 amber-seaslug）
• 终端用户界面: cd tools/shodh-memory && ./shodh-tui（查看图谱与活动）

快速使用

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": "测试记忆", "memory_type": "Learning", "tags": ["test"]}'

核心工具

• 记录记忆: /api/remember（记忆类型：学习/观察/对话/任务/偏好）
• 回忆记忆: /api/recall（语义搜索） | /api/recall/tags（按标签搜索）
• 主动上下文: /api/proactive_context（自动获取相关记忆）
• 待办事项: /api/todos/add（添加） | /api/todos（列出） | /api/todos/complete（完成）
• 项目管理: /api/projects/add（添加） | /api/projects（列出）
• 上下文摘要: /api/context_summary

完整 API 文档：reference/api.md

最佳实践

• 用户 ID: 主用户使用 henry，系统使用 openclaw，子代理使用 task-XYZ 格式
• 标签: 始终为记忆添加标签以便筛选（例如 ["openclaw", "project-backend"]）
• 回复前: 回忆最近的上下文以保持对话连贯性
• 定期检查: 每日查看待办事项
• 系统维护: 每周重启服务器（process kill amber-seaslug 后重新启动）

查看 reference/examples.md 了解 OpenClaw 使用模式。