在开发智能体时,上下文记忆的管理往往依赖于临时对话或未标准化的存储方式。DSH 提倡插件化架构,dsh-agent-memory 正是为了解决 Claw Agent 的记忆持久化问题而设计的独立插件。它为每个 Agent 提供 USER / MEMORY 金库、日记和回合后回顾机制。
核心功能¶
- 金库与日记:每个 Claw Agent 拥有独立的 USER 和 MEMORY 金库,以及按日期归档的日记文件。
- 回合后回顾:在每轮对话结束后,根据设置执行回顾操作。
- 压缩同步:在官方会话压缩开始时,插件监听
session/event的compaction/start事件,并立即将需要写入的内容存入金库。 - 配置选项:支持设置记忆写入是“自由写”还是“需审批”,以及“回顾开关”的开启状态。
- 作用域隔离:
- Claw 会话只读自己的金库。
- 工作区 / 官方会话不注入 Claw 记忆。
memory工具只挂在 Claw 会话上。
安装与启用¶
安装前建议先安装 dsh-agent-registry 和 dsh-agent-identity。
- 通过 GitHub 安装:
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-memory
- 本地开发安装:
dsh plugin --profile web add link:/abs/path/to/dsh-agent-memory
- 重启服务:
安装完成后重启dsh web。
数据存储位置¶
插件运行时会生成以下文件:
- 金库文件:
~/.dsh/DSclaw/<slug>/USER.md~/.dsh/DSclaw/<slug>/MEMORY.md
- 日记文件:
~/.dsh/DSclaw/<slug>/memory/YYYY-MM-DD.md
- 全局配置:
~/.dsh/agent-memory/settings.json
注意事项¶
- 工具挂载:
memory工具仅挂在 Claw 会话上(DSH 0.1.6+ 版本采用串行初始化)。 - 卸载行为:卸载后,上述文件仍保留在磁盘上,但插件不再注入、不再执行回顾,
memory工具会消失。 - 权限与安全:插件以当前 dsh 进程权限运行,安装前请检查源码与许可证。
该插件为 DSH 下的 Claw Agent 提供了标准化的记忆层。更多细节可参考项目目录或源码。