#第 15 章：Memory 记忆系统深入

# 查看记忆目录
ls -la ~/.openclaw/workspace/memory/

cat ~/.openclaw/workspace/MEMORY.md

# 方式 1：直接创建记忆文件
cat > ~/.openclaw/workspace/memory/2026-03-06-security-config.md << 'EOF'
# 安全配置经验总结

> 创建时间: 2026-03-06
> 分类: system-ops
> 标签: security, exec-approvals, permissions
> 重要性: high
> 状态: active

## 关键内容

1. exec-approvals.json 的默认策略建议设为 "prompt"
2. 危险命令（rm -rf, mkfs 等）应设为 "deny"
3. Git 只读操作可安全设为 "allow"
4. 新安装的 Skill 默认使用 "standard" 沙箱模式

## 经验教训

- 先从严格模式开始，逐步放宽权限
- 变更安全配置前一定要备份
- 定期查看审计日志发现异常
EOF

# 方式 2：通过 Agent 对话创建（在与 Agent 交互时）
# 用户输入："请记住以下信息——我的 GitHub 用户名是 zxk，
#            主要仓库在 github.com/zxk/openclaw-tutorial-auto"
# Agent 会自动创建对应的记忆文件

# 通过 OpenClaw CLI 查看记忆系统状态
openclaw memory status

# 按关键词搜索记忆
grep -rl "tavily" ~/.openclaw/workspace/memory/

# 按分类搜索
grep -l "分类: skill-experience" ~/.openclaw/workspace/memory/*.md

# 按标签搜索
grep -l "标签:.*security" ~/.openclaw/workspace/memory/*.md

# 按日期范围搜索（2026 年 3 月的所有记忆）
ls ~/.openclaw/workspace/memory/2026-03-*.md

# 搜索高重要性记忆
grep -l "重要性: high" ~/.openclaw/workspace/memory/*.md

# 使用 openclaw doctor 检查记忆系统健康状态
openclaw doctor --check memory

# 追加内容到已有记忆
cat >> ~/.openclaw/workspace/memory/2026-03-06-security-config.md << 'EOF'

## 更新记录

### 2026-03-06 补充
- 发现 Vault 集成需要额外配置 VAULT_TOKEN 环境变量
- 凭证加密使用 AES-256-GCM 算法，密钥派生自设备指纹
EOF

# 修改记忆状态（将短期记忆升级为长期记忆）
sed -i 's/> 状态: active/> 状态: permanent/' \
  ~/.openclaw/workspace/memory/2026-03-06-security-config.md

# 直接删除（不可恢复）
rm ~/.openclaw/workspace/memory/2026-01-15-obsolete-info.md

# 安全删除（先归档再删除）
mkdir -p ~/.openclaw/workspace/memory/archive/
mv ~/.openclaw/workspace/memory/2026-01-15-obsolete-info.md \
   ~/.openclaw/workspace/memory/archive/

# 批量归档过期记忆
find ~/.openclaw/workspace/memory/ -name "*.md" -mtime +30 \
  -exec grep -l "重要性: low" {} \; | while read f; do
    mv "$f" ~/.openclaw/workspace/memory/archive/
    echo "已归档: $(basename $f)"
done

# 按分类统计记忆文件数量
for category in identity skill-experience task-record system-ops knowledge decision-log; do
  count=$(grep -l "分类: $category" ~/.openclaw/workspace/memory/*.md 2>/dev/null | wc -l)
  printf "%-20s %d 条\n" "$category" "$count"
done

# 提取所有使用过的标签及其频率
grep "^> 标签:" ~/.openclaw/workspace/memory/*.md | \
  sed 's/.*标签: //' | tr ',' '\n' | sed 's/^ //' | \
  sort | uniq -c | sort -rn | head -20

# 查看 Agent 启动时加载的文件
ls -la ~/.openclaw/workspace/{IDENTITY,USER,MEMORY,SOUL}.md

# 模拟 Agent 创建记忆的完整流程
TOPIC="docker-deploy-tips"
DATE=$(date +%Y-%m-%d)
FILE="~/.openclaw/workspace/memory/${DATE}-${TOPIC}.md"

# 创建记忆文件
cat > "$FILE" << 'EOF'
# Docker 部署经验

> 创建时间: 2026-03-06
> 分类: system-ops
> 标签: docker, deploy, tips
> 重要性: medium
> 状态: active

## 关键内容

- OpenClaw 容器建议使用 `--restart=unless-stopped` 策略
- 数据目录 `~/.openclaw/` 应挂载为 Docker Volume
- 容器内的 Agent 会话日志存储在 `/root/.openclaw/agents/`
EOF

# 更新 MEMORY.md 索引（追加条目）
echo "- \`${DATE}-${TOPIC}.md\` — Docker 部署实践经验" >> \
  ~/.openclaw/workspace/MEMORY.md

echo "✅ 记忆已创建并更新索引"

# Agent 内部执行的检索逻辑（等效命令）
grep -rl "web.*search\|搜索.*配置\|tavily" \
  ~/.openclaw/workspace/memory/*.md | \
  head -5

# 诊断记忆膨胀
echo "=== 记忆系统健康检查 ==="
echo "文件总数: $(ls ~/.openclaw/workspace/memory/*.md 2>/dev/null | wc -l)"
echo "总大小: $(du -sh ~/.openclaw/workspace/memory/ | cut -f1)"
echo "最大文件: $(ls -lS ~/.openclaw/workspace/memory/*.md | head -1 | awk '{print $5, $NF}')"
echo "最旧文件: $(ls -lt ~/.openclaw/workspace/memory/*.md | tail -1 | awk '{print $6,$7,$8, $NF}')"
echo "本周新增: $(find ~/.openclaw/workspace/memory/ -name '*.md' -mtime -7 | wc -l)"

# 示例：合并所有 web-search 相关的记忆
# 步骤 1：找出相关文件
grep -l "标签:.*web-search" ~/.openclaw/workspace/memory/*.md

# 步骤 2：创建合并后的文件
cat > ~/.openclaw/workspace/memory/2026-03-06-web-search-consolidated.md << 'EOF'
# Web 搜索能力综合经验

> 创建时间: 2026-03-06
> 分类: skill-experience
> 标签: web-search, tavily, search, consolidated
> 重要性: high
> 状态: active
> 合并来源: 2026-03-03-web-search.md, 2026-03-04-tavily-key.md,
>           2026-03-05-search-optimization.md

## Tavily API 配置

- API Key 存放在 credentials/tavily-api-key.json
- 免费套餐：1000 次/月，5 次/分钟
- 推荐使用 search_depth: "advanced"

## 搜索优化技巧

- 使用具体的关键词而非长句
- 中英文混合搜索效果更好
- 对结果进行二次过滤和摘要

## 常见问题处理

- 429 错误：等待 60 秒重试
- 超时：advanced 模式建议设置 10s 超时
- 空结果：尝试简化查询或更换搜索引擎
EOF

# 步骤 3：归档旧文件
mkdir -p ~/.openclaw/workspace/memory/archive/
mv ~/.openclaw/workspace/memory/2026-03-03-web-search.md \
   ~/.openclaw/workspace/memory/archive/
mv ~/.openclaw/workspace/memory/2026-03-04-tavily-key.md \
   ~/.openclaw/workspace/memory/archive/
mv ~/.openclaw/workspace/memory/2026-03-05-search-optimization.md \
   ~/.openclaw/workspace/memory/archive/

# 步骤 4：更新 MEMORY.md 索引
echo "✅ 记忆合并完成，3 个文件合并为 1 个"

# 完整的手动清理流程

# 1. 评估当前状态
echo "=== 清理前状态 ==="
ls ~/.openclaw/workspace/memory/*.md | wc -l
du -sh ~/.openclaw/workspace/memory/

# 2. 找出可安全清理的文件
echo "=== 低重要性 + 30 天以上 ==="
find ~/.openclaw/workspace/memory/ -name "*.md" -mtime +30 \
  -exec grep -l "重要性: low" {} \;

# 3. 找出可合并的文件（同分类）
echo "=== 分类文件数统计 ==="
grep -h "^> 分类:" ~/.openclaw/workspace/memory/*.md 2>/dev/null | \
  sort | uniq -c | sort -rn

# 4. 执行归档
mkdir -p ~/.openclaw/workspace/memory/archive/
# ... 移动文件 ...

# 5. 验证清理结果
echo "=== 清理后状态 ==="
ls ~/.openclaw/workspace/memory/*.md | wc -l
du -sh ~/.openclaw/workspace/memory/

# 快速检查记忆系统健康度
openclaw doctor --check memory

# 查看记忆统计信息
openclaw memory status

# 查找缺少元数据的记忆文件
for f in ~/.openclaw/workspace/memory/*.md; do
  grep -qL '分类:' "$f" && echo "缺少分类: $f"
done

# 步骤 1：查看 MEMORY.md 索引
cat ~/.openclaw/workspace/MEMORY.md

# 步骤 2：统计记忆文件
echo "文件数量: $(ls ~/.openclaw/workspace/memory/*.md | wc -l)"
echo "总大小: $(du -sh ~/.openclaw/workspace/memory/ | cut -f1)"

# 步骤 3：查看最新的 3 条记忆
ls -lt ~/.openclaw/workspace/memory/*.md | head -3

# 步骤 4：读取一条记忆的内容
head -20 ~/.openclaw/workspace/memory/$(ls -t ~/.openclaw/workspace/memory/ | head -1)

# 步骤 1：确定记忆主题和内容
TOPIC="memory-system-practice"
DATE=$(date +%Y-%m-%d)

# 步骤 2：创建记忆文件
cat > ~/.openclaw/workspace/memory/${DATE}-${TOPIC}.md << 'EOF'
# Memory 系统学习笔记

> 创建时间: 2026-03-06
> 分类: knowledge
> 标签: memory, learning, openclaw
> 重要性: medium
> 状态: active

## 关键内容

1. OpenClaw 记忆分为三种类型：工作记忆、短期记忆、长期记忆
2. 记忆文件命名格式：YYYY-MM-DD-topic.md
3. MEMORY.md 是记忆系统的全局索引
4. 记忆检索使用语义匹配 + 关键词 + 时间衰减的混合策略
5. 定期合并清理防止记忆膨胀

## 实践体会

- 创建记忆时分类和标签要认真填写，影响后续检索效率
- 高重要性记忆衰减慢，适合存储核心知识
- 合并策略能有效控制文件数量
EOF

# 步骤 3：验证文件格式
echo "=== 元数据检查 ==="
head -7 ~/.openclaw/workspace/memory/${DATE}-${TOPIC}.md

# 步骤 4：检查文件名规范
echo "=== 文件名: ${DATE}-${TOPIC}.md ==="
[[ "${DATE}-${TOPIC}.md" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+\.md$ ]] && \
  echo "✅ 文件名格式正确" || echo "❌ 文件名格式不正确"

# 方式 1：关键词搜索
echo "=== 搜索包含 'mcp' 的记忆 ==="
grep -rl "mcp" ~/.openclaw/workspace/memory/*.md

# 方式 2：按分类搜索
echo "=== 搜索 skill-experience 分类 ==="
grep -l "分类: skill-experience" ~/.openclaw/workspace/memory/*.md

# 方式 3：按时间搜索（最近 7 天）
echo "=== 最近 7 天的记忆 ==="
find ~/.openclaw/workspace/memory/ -name "*.md" -mtime -7 -printf "%T+ %p\n" | sort -r

# 方式 4：按重要性搜索
echo "=== 高重要性记忆 ==="
grep -l "重要性: high" ~/.openclaw/workspace/memory/*.md

# 方式 5：多条件组合搜索
echo "=== 高重要性 + 包含 api ==="
grep -l "重要性: high" ~/.openclaw/workspace/memory/*.md | \
  xargs grep -l "api" 2>/dev/null

# 步骤 1：诊断当前状态
echo "=== 记忆系统诊断 ==="
echo "文件总数: $(ls ~/.openclaw/workspace/memory/*.md 2>/dev/null | wc -l)"
echo ""
echo "=== 按分类统计 ==="
grep -h "^> 分类:" ~/.openclaw/workspace/memory/*.md 2>/dev/null | \
  sort | uniq -c | sort -rn

# 步骤 2：找出分类文件数超过 3 个的候选合并目标
echo ""
echo "=== 建议合并的分类 ==="
grep -h "^> 分类:" ~/.openclaw/workspace/memory/*.md 2>/dev/null | \
  sort | uniq -c | sort -rn | awk '$1 > 3 {print $0, " ← 建议合并"}'

# 步骤 3：创建归档目录（如果不存在）
mkdir -p ~/.openclaw/workspace/memory/archive/

# 步骤 4：在 Agent 对话中请求自动合并
# 输入："请检查 memory/ 目录，找出可以合并的相关记忆，
#        执行合并并更新 MEMORY.md 索引"

# 直接编辑记忆文件
vim ~/.openclaw/workspace/memory/2026-03-06-my-memory.md

# 编辑后 Agent 会在下次读取时获取更新内容