Claude Memory 优化器

适用于 OpenClaw 的结构化记忆系统，支持四类分类与自动化迁移。

适用场景

• 在 OpenClaw 中首次设置记忆系统
• 将未结构化的 memory/*.md 文件迁移到分类目录中
• 通过语义化的 frontmatter 提升记忆检索效果
• 实现类似 Claude Code 的记忆架构

核心功能

• 四类分类：user（用户）、feedback（反馈）、project（项目）、reference（参考）
• Frontmatter 元数据：使用 structured name/description/type 支持语义搜索
• 自动迁移：一键命令完成现有记忆文件的重构
• 日志模式：可选的追加式每日日志（KAIROS 风格）

快速上手

安装

clawhub install claude-memory-optimizer

执行迁移

# 自动检测工作区
node ~/.openclaw/skills/claude-memory-optimizer/scripts/refactor-memory.js

# 或手动指定路径
node ~/.openclaw/skills/claude-memory-optimizer/scripts/refactor-memory.js ~/.openclaw/workspace

验证结果

ls -la ~/.openclaw/workspace/memory/
cat ~/.openclaw/workspace/MEMORY.md

记忆类型说明

目录结构

memory/
├── user/          # 用户信息
├── feedback/      # 行为指导
├── project/       # 项目上下文
├── reference/     # 外部引用
└── logs/          # 追加式日志（可选）
    └── YYYY/
        └── MM/
            └── YYYY-MM-DD.md

记忆文件格式

每个记忆文件使用 frontmatter 元数据：

---
name: 数据科学背景
description: 用户是专注于可观测性与大模型的数据科学家
type: user
---

用户就读于北京工业大学与都柏林大学，GPA 3.95/4.2。
研究方向：大模型、AI Agent、MCP。

**技能：** Python、PyTorch、Transformers、NLP

**应用方式：** 使用数据科学术语，假设具备机器学习背景。

不应保存的内容

• 代码模式、架构设计、文件路径（可从代码库推导）
• Git 提交历史、最近变更（使用 git log 查看）
• 调试解决方案（修复已包含在代码中）
• 已存在于 CLAUDE.md 中的内容
• 仅当前会话有用的临时任务细节

配置说明

OpenClaw 配置

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "enabled": true,
        "provider": "local",
        "maxResults": 20,
        "minScore": 0.3
      },
      "compaction": {
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 4000
        }
      }
    }
  }
}

使用示例

保存用户偏好

用户：“记住，我偏好简洁回复，不要尾部总结。”

AI：将内容保存至 memory/feedback/reply-style.md：

---
name: 回复风格偏好
description: 用户希望回复简洁，无需尾部总结
type: feedback
---

**规则：** 回复保持简洁，不添加尾部总结。

**原因：** 用户表示“我自己能看 diff”。

**如何应用：** 在完成任务后直接结束回复。

检索记忆

用户：“我之前对数据库测试说过什么？”

AI：执行 memory_search query="database testing" → 返回 memory/feedback/db-testing.md

验证记忆有效性

用户：“dong-thesis.md 中的实验设计是否仍然有效？”

AI：执行 grep 检查 → 发现信息过时 → 更新记忆文件。

迁移指南

迁移前

memory/
├── 2026-03-21.md
├── 2026-03-28.md
├── research-memory.md
└── video-memory.md

迁移后

memory/
├── project/
│   ├── 2026-03-21-.md
│   ├── 2026-03-28-.md
│   └── research-memory.md
├── reference/
│   └── video-memory.md
└── logs/2026/04/2026-04-02.md

高级功能

语义检索（未来支持）

async function findRelevantMemories(query: string, memoryDir: string) {
  const memories = await scanMemoryFiles(memoryDir);
  const selected = await selectRelevantMemories(query, memories);
  return selected.slice(0, 5); // 返回最相关的前 5 条记忆
}

回忆时的验证机制（未来支持）

在推荐记忆内容前：

1. 若记忆提及文件名 → 使用 ls 验证是否存在
2. 若记忆提及函数名 → 使用 grep 确认是否仍存在
3. 若记忆与当前状态冲突 → 以当前观察为准，更新记忆

“记忆说 X 存在” ≠ “X 当前仍然存在”

维护建议

每日维护（心跳）

• 向 memory/YYYY-MM-DD.md 追加记录
• 记录决策、对话、学习心得

每周回顾

• 阅读每日笔记
• 提炼重要信息至 MEMORY.md
• 清理过时条目

每月审计

• 审查项目进展
• 更新长期目标
• 检查 .learnings/ 中的记录

故障排查

记忆未加载

• 确保工作区根目录存在 MEMORY.md
• 检查 agents.defaults.memorySearch.enabled = true
• 重启 OpenClaw 网关

检索质量差

• 在 frontmatter 中添加具体 description
• 使用一致的关键词
• 调整 minScore（数值越低，匹配范围越广）

迁移失败

• 先备份 memory/ 目录
• 使用 --dry-run 选项预演（如可用）
• 检查文件权限

参考资料

• Claude Code：src/memdir/（memdir.ts, memoryTypes.ts, findRelevantMemories.ts）
• OpenClaw 文档：docs/concepts/memory.md
• 相关技能：memory-setup-openclaw, elite-longterm-memory

许可证

MIT-0