Agent Memory System Guide

🧠 面向 OpenClaw 和 Obsidian 的 Agent 长期记忆搭建指南。用最小可用的 MEMORY.md、每日笔记和归档流程，先搭起来，再逐步蒸馏。

触发词

记忆系统、memory-setup、搭建记忆、记忆架构

5 分钟快速上手

如果你赶时间，只做三步：

第一步：创建 MEMORY.md

# MEMORY.md

> 长期记忆。只保留会持续影响协作的事实、偏好和决策。

## User

- Preferred name: K
- Timezone: Asia/Shanghai

## 当前任务

- [ ] 正在做的事

## 决策记录

- YYYY-MM-DD: 决策内容 + 原因

## 踩坑记录

- 问题 → 解决方案

第二步：创建每日笔记

# memory/2026-03-20.md

## 完成
- 分析了网宿科技

## 决策
- 暂不加仓

## 踩坑
- （无）

## 待办
- [ ] 明天要做什么

第三步：从模板创建 SESSION-STATE.md 和 working-buffer.md

# SESSION-STATE.md

## 当前任务
- 任务名称

## 已完成
- ...

## 卡点
- ...

## 下一步
- ...

## 恢复信息
- 最近一次有效上下文：...

# working-buffer.md

## 进行中
- ...

## 临时决策
- ...

## 未完成
- ...

第四步：每次对话开始时

先读 SESSION-STATE.md，再读最近 1-3 天 daily notes，最后才做 memory_search。
memory_search(query="相关关键词")

核心架构（三层模型）

• MEMORY.md：长期记忆，精炼保存
• memory/YYYY-MM-DD.md：每日原始记录
• SESSION-STATE.md：当前任务真相来源
• working-buffer.md：短期工作缓冲
• templates/SESSION-STATE.md：恢复状态模板
• templates/working-buffer.md：工作缓冲模板
• Obsidian：长期归档与备份

启动与结束顺序

• 启动时：先读 SESSION-STATE.md，再读最近 1-3 天 daily notes，最后才检索本地记忆
• 结束时：先更新 SESSION-STATE.md，再把稳定事实蒸馏进 MEMORY.md，最后归档 daily notes
• 中断后恢复：优先从 working-buffer.md 续接未完成项
• 仓库模板：先复制 templates/SESSION-STATE.md 和 templates/working-buffer.md，再填入当前任务

OpenViking 可选增强

• OpenViking 不是强依赖；没有它也能完成核心的断点续接流程
• 有 OpenViking 时，优先把它作为语义召回和摘要补全层
• OpenViking 负责补充相关记忆，SESSION-STATE.md 负责保存当前任务真相
• 如果 OpenViking 不可用，直接退回到 SESSION-STATE.md + working-buffer.md + daily notes 的本地流程

维护原则

• 下次对话会用到的 → 保留在本地记忆
• 可能永远用不到但值得保留的 → 归档到 Obsidian
• 记忆膨胀时，先蒸馏再保留

兼容性

• OpenClaw-compatible skill
• Codex-compatible skill
• OpenViking-compatible optional enhancement
• Obsidian vault workflows