总结:Openclaw Skills 的高级记忆管理

作者:互联网

2026-03-31

AI教程

什么是 总结:结构化记忆与经验管理?

总结是 Openclaw Skills 生态系统中的核心组件,旨在桥接临时聊天会话与长期智能体智能之间的鸿沟。通过实施先进的三层记忆协议,该技能允许开发者将原始的技术交互转化为高价值、结构化的 Markdown 文档。它确保了关键洞察——如系统修复、核心人设规则和配置更改——永远不会丢失,而是经过提炼和索引以便未来检索。

该技能对于需要 AI 智能体从过去的错误和成功中学习的开发者来说尤为强大。通过使用总结,你可以在保持精简上下文窗口的同时,仍然让你的智能体能够访问海量的历史知识库。它代表了一种专业的知识结晶方法,确保每一次重要的调试会话都能为你的 Openclaw Skills 设置的整体智能做出贡献。

下载入口:https://github.com/openclaw/skills/tree/main/skills/marklyk/zongjie

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install zongjie

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 zongjie。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

总结:结构化记忆与经验管理 应用场景

  • 记录系统故障排除步骤和根因分析,供未来参考。
  • 持久化 AI 智能体人设定义和核心操作规则。
  • 记录复杂的配置更改和基础设施部署步骤。
  • 存档具有长期参考价值的宝贵调试过程。
  • 将来自多个会话的零散见解整合到统一的技术知识库中。
总结:结构化记忆与经验管理 工作原理
  1. 该技能首先评估当前交互的价值,以过滤掉简单的问答或闲聊。
  2. 它根据数据的持久性和重要性分配优先级(P0-P2)和记忆层(L0-L2)。
  3. 智能体提取核心信息,包括问题描述、根本原因和逐步解决方案。
  4. 它对现有记录进行检查,将新见解合并到相关的现有文件中,防止数据重复。
  5. 结构化内容被保存到专用记忆目录下的分类 Markdown 文件中。
  6. 最后,通过 CLI 管理脚本更新中央记忆索引,确保智能体在未来的会话中可以检索到信息。

总结:结构化记忆与经验管理 配置指南

要在你的 Openclaw Skills 环境中启用高级记忆管理,请按如下方式配置记忆目录和管理脚本:

# 创建所需的目录结构
mkdir -p memory/topics/

# 初始化核心记忆文件
touch memory/topics/01-persona.md
touch memory/topics/02-op_rules.md
touch memory/topics/03-system_debug.md

# 确保记忆管理器脚本可执行
chmod +x ~/.openclaw/scripts/memory_mgr.py

总结:结构化记忆与经验管理 数据架构与分类体系

该技能使用分层分类法组织数据,以平衡访问速度与存储深度。这对于保持高效的 Openclaw Skills 性能至关重要。

等级 描述 加载频率
L0 核心索引与人设 每次会话均加载
L1 重要经验 会话开始时加载
L2 存档记录 通过显式查询加载
优先级 有效期 用途
P0 永久 核心人设和操作规则
P1 90 天 重要的解决方案和配置
P2 30 天 临时日志和调试步骤

Skill: 总结 (Zongjie)

将重要事件整理成结构化文档,沉淀经验到记忆系统。

记忆管理系统

基于 OpenViking 方案的三层记忆系统:

层级 说明 加载时机
L0 核心索引,始终加载 每次会话
L1 重要记忆,按需加载 会话开始时
L2 归档记忆,查询加载 显式查询时
优先级 生命周期 说明
P0 永不过期 核心人设、操作规则、关键偏好
P1 90天 重要经验、解决方案
P2 30天 临时记录,自动清理

使用场景

  • 系统故障排查完成
  • 有参考价值的调试过程
  • 需要记录解决方案供以后查阅
  • 不保存:简单的问答、查询、闲聊

精简模板

# 标题

> P1 | L1

### 问题
- [简明描述]

### 根因
- [根本原因]

### 解决步骤
1. 步骤1
2. 步骤2
3. 步骤3

### 关键信息
- 报错信息/日志
- 关键命令
- 参考链接

### 结果
- ?/? 状态

### 经验
- 关键点

步骤

M1: 判断价值

以下情况不保存

  • 简单问答(如"这个公司怎么样")
  • 查询类(如"帮我查下天气")
  • 闲聊

以下情况需要保存

  • 系统故障及修复
  • 配置变更
  • 重要决策
  • 调试过程

M2: 确定优先级

根据内容判断 P/L 级别:

分类 P级 L级 示例
人设/操作规则 P0 L0 核心规则、沟通原则
系统故障修复 P1 L1 Gateway崩溃、Cron失败
新功能配置 P1 L1 GitHub同步、自动备份
调试过程 P2 L2 排查步骤、临时方案

M3: 详细整理

提取核心信息:

  • 问题是什么
  • 根因是什么
  • 解决步骤(一步一步写清楚)
  • 关键信息(报错日志、命令、链接)
  • 结果如何
  • 经验教训(1-2条)

M4: 合并同类项

检查现有记录:

  • 如果已有相同/类似问题 → 合并到已有记录中
  • 更新"解决步骤"部分
  • 更新"经验"部分

M5: 保存分类

分类文件

  • 系统问题memory/topics/03-系统调试.md
  • 操作规则memory/topics/02-操作规则.md
  • 人设偏好memory/topics/01-人设.md
  • 新功能memory/topics/04-XXX.md
  • 其他memory/YYYY-MM-DD.md

索引更新 (可选):

# 更新索引
python3 ~/.openclaw/scripts/memory_mgr.py add  "<内容>" P1 L1

M6: 输出确认

告诉用户保存位置和 P/L 分类。

示例

用户:"帮我记录今天 Cron 推送失败的排查"

→ 检查发现已有类似记录 → 合并更新:

# Cron 推送失败修复

> P1 | L1

### 问题
- Cron 早间推送失败 (announce delivery failed)

### 根因
- .openclaw/openclaw.json 有 JSON 尾随逗号

### 解决步骤
1. 检查 cron 状态: `openclaw cron list`
2. 手动测试 T@elegrimm: `openclaw message send ...`
3. 检查 JSON: `python3 -m json.tool ~/.openclaw/openclaw.json`
4. 修复 JSON 语法错误
5. 重新安装: `npm install -g openclaw`
6. 重启: `openclaw gateway restart`

### 关键信息
- 报错: "cron announce delivery failed"
- 日志: `openclaw logs --limit 50`
- 配置: `~/.openclaw/openclaw.json`

### 结果
- ? 推送恢复正常

### 经验
- JSON 错误会导致投递失败
- 重新安装解决模块丢失

常用命令

# 添加记忆 (通过脚本)
python3 ~/.openclaw/scripts/memory_mgr.py add work "内容" P1 L1

# 查询记忆
python3 ~/.openclaw/scripts/memory_mgr.py query work

# 获取 L0 摘要
python3 ~/.openclaw/scripts/memory_mgr.py layer work L0

# 共享记忆
python3 ~/.openclaw/scripts/memory_mgr.py shared add "项目规范" "..."