本地认知记忆

技能简介

Shodh-Local 是面向 AI 智能体的本地优先认知记忆系统，支持离线运行。通过语义召回、GTD 待办与项目管理、知识图谱等功能，实现持久化记忆存储与主动上下文推送。

业务背景

满足企业对数据主权与离线可用的双重需求。AI代理在本地完成记忆存储与语义检索，无需联网即可调取历史上下文；GTD与知识图谱结合，将零散信息转化为可执行的工作流，降低任务遗漏风险。

落地案例：一名项目经理部署Shodh-Local后，每日将会议要点以Conversation类型存入，系统自动关联相关项目标签。后续查询某客户需求时，语义召回不仅返回原始记录，还主动推送待办事项中关联的交付节点，实现信息到行动的闭环。

能做什么

• 保存并分类记忆（学习/观察/对话/任务/偏好）
• 基于语义的智能回忆与标签筛选
• 自动推送相关上下文（ proactive context ）
• GTD 待办与项目跟踪管理
• 生成会话摘要与知识图谱可视化

使用说明

1. 安装部署：下载 shodh-memory-server 二进制文件，确保可执行或加入 PATH；数据默认存放于 ./shodh-data
2. 启动服务：运行 ./shodh-memory-server，服务监听 localhost:3030（进程名 amber-seaslug）
3. 获取密钥：通过服务器生成 X-API-Key，写入 TOOLS.md 配置
4. 调用示例：

   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"]}'

5. TUI 面板：进入 tools/shodh-memory 目录，执行 ./shodh-tui 查看图谱与活动
6. 日常维护：每周重启一次服务（process kill amber-seaslug 后重新启动）

输入与输出

见下方输入与输出表格。

风险提示

• 服务宕机将导致记忆功能不可用，需监控进程状态
• API 密钥泄露可导致本地数据被未授权访问
• 长期运行可能出现内存泄漏，建议定期重启
• 数据仅存储于本地，无云端备份机制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/doobidoo/shodh-local/SKILL.md
来源类型：GitHub 仓库