Agent Memory System Guide

Files (39)

• INSTALL.md
• README.md
• README_CN.md
• README_EN.md
• SKILL.md
• _meta.json
• 2026-03-21-agent-memory-system-guide-obsidian-native.md · docs/superpowers/plans/
• 2026-03-25-memory-backup-import-export.md · docs/superpowers/plans/
• 2026-03-25-memory-examples-maintenance.md · docs/superpowers/plans/
• 2026-03-25-report-warning-example.md · docs/superpowers/plans/
• 2026-03-26-import-clean-mode.md · docs/superpowers/plans/
• 2026-03-26-metadata-bootstrap-safety.md · docs/superpowers/plans/
• 2026-03-27-memory-positioning.md · docs/superpowers/plans/
• 2026-03-27-report-json.md · docs/superpowers/plans/
• 2026-03-21-agent-memory-system-guide-obsidian-design.md · docs/superpowers/specs/
• 2026-03-25-memory-backup-import-export-design.md · docs/superpowers/specs/
• 2026-03-25-memory-examples-maintenance-design.md · docs/superpowers/specs/
• 2026-03-26-import-clean-mode-design.md · docs/superpowers/specs/
• 2026-03-26-metadata-bootstrap-safety-design.md · docs/superpowers/specs/
• 2026-03-27-memory-positioning-design.md · docs/superpowers/specs/
• 2026-03-27-report-json-design.md · docs/superpowers/specs/
• manifest.toml
• memory_capture.py · scripts/
• OBSIDIAN-NOTE.md · templates/
• SESSION-STATE.md · templates/
• memory-capture.md · templates/
• working-buffer.md · templates/
• test_gitignore_publish_artifacts.py · tests/
• test_install_contract.py · tests/
• test_memory_capture_contract.py · tests/
• test_memory_capture_script.py · tests/
• test_memory_recovery_contract.py · tests/
• test_obsidian_contract.py · tests/
• test_obsidian_template_contract.py · tests/
• test_openclaw_memory_search_contract.py · tests/
• test_openviking_optional_contract.py · tests/
• test_readme_openviking_optional.py · tests/
• test_release_manifest_contract.py · tests/
• test_skill_positioning_contract.py · tests/

SKILL.md (first lines)

# Agent 记忆系统搭建指南 Skill

> 🧠 从零搭建 Agent 长期记忆系统。基于 OpenClaw 实战，覆盖本地优先的 `MEMORY.md`、每日笔记、`SESSION-STATE.md`、`working-buffer.md`、Obsidian 原生笔记与可选召回后端全流程。

## 触发词

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

## ⚡ 5 分钟快速上手

**如果你赶时间，只需做这几步：**

### 第一步：创建 `MEMORY.md`

```markdown
# MEMORY.md

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

## User

- Preferred name: K
- Timezone: Asia/Shanghai

## 当前任务

- [ ] 正在做的事

## 决策记录

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

## 踩坑记录

- 问题 → 解决方案
```

### 第二步：创建每日笔记

```markdown
# memory/2026-03-20.md

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

## 决策
- 暂不加仓

## 踩坑
- （无）

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

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

```markdown
# SESSION-STATE.md

## 当前任务
- 任务名称

## 已完成
- ...

## 卡点
- ...

## 下一步
- ...

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

```markdown
# working-buffer.md

## 进行中
- ...

## 临时决策
- ...

## 未完成
- ...
```

模板来源：

- `templates/SESSION-STATE.md`
- `templates/working-buffer.md`

### 恢复层契约先写死

- `SESSION-STATE.md` 只使用仓库模板提供的简洁结构：`当前任务`、`已完成`、`卡点`、`下一步`、`恢复信息`
- 不要写入 `Task`、`Status`、`Owner`、`Last Updated`、`Cleanup Rule` 这类另一套 schema 字段
- 如果外部 skill 产出的是详细版字段：
  - `Current Task` 合并到 `当前任务`
  - `Status` 合并到 `已完成`、`卡点` 或 `下一步`
  - `Owner`、`Last Updated`、`Cleanup Rule` 只在条目文本里按需保留，不扩展新标题
- `working-buffer.md` 是唯一的短期毛坯区
- 其他 skill 如果也有 working buffer 概念，应复用这个文件
- 不要再创建第二份并行写入的 WAL / buffer 文件
- `MEMORY.md` 用于启动时快速参考
- `memory/` 用于每日笔记和深度归档
- 两者允许主题重叠，但检索顺序不同：先 `SESSION-STATE.md`，再 recent notes，再 `MEMORY.md` / `memory_search`，最后再查归档

### 第四步：使用 Obsidian 原生笔记模板

```markdown
# templates/OBSIDIAN-NOTE.md

---
title: ""
aliases: []
tags: []
type: memory

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills