你有没有想过,每次 Agent 犯的错、你纠正的话、踩过的坑……如果它都能自己记住,下次不再犯,该多好?
Self-Improving-Agent 就是干这个的。
- 一、它是什么?能干嘛?
- 二、安装(三种方式任选)
- 三、安装后配置
- 四、安装后的目录结构
- 五、工作原理:什么时候会触发记录?
- 六、学习记录的”晋升”路径
- 七、验证安装成功
- 八、安全提示
- 九、小贴士
Self-Improving-Agent 是一个 OpenClaw Skill,核心能力就一句话:
让 Agent 把犯过的错、学到的东西、用户的纠正,全部结构化地记下来,并在后续会话中自动参考。
具体来说,它会在以下场景被触发:
它会把这些记录以结构化 Markdown 条目的形式写入 目录下的日志文件,每条记录包含:ID、时间戳、优先级、状态、区域标签、摘要、复现步骤、建议修复和元数据。
听起来很简单,但持续积累下来,Agent 就会越用越聪明 —— 这就是”自我进化”的含义。
方式一:Git Clone(推荐 ✅)
最直接的方式,把仓库克隆到 OpenClaw 的 skills 目录下:
方式二:通过 npx playbooks 安装
如果你习惯用 playbooks CLI:
方式三:直接让 Agent 自己装
没错,你可以把仓库链接丢给 Agent,让它自己处理:
Agent 会在后台自动完成克隆和配置。不过为了确保万无一失,建议安装完手动检查一下。
克隆下来只是第一步,还需要做几项配置才能真正生效。
Step 1:创建 .learnings 目录和日志文件
在你的 OpenClaw workspace 下创建 目录和三个日志文件:
创建日志文件(也可以从 Skill 自带的 目录复制模板):
三个文件各司其职:
Step 2:安装 Hook(可选但推荐)
Hook 可以让 Skill 在特定事件发生时自动激活,而不需要你每次手动提醒 Agent。
Step 3:配置 Hook 触发器(可选,进阶)
Hook 可以启用自动提醒功能。这是可选的 —— 你必须显式配置。
基础配置(用户每次提交 prompt 时触发):
进阶配置(额外监听 Bash 工具调用,自动检测错误):
说明: + 的组合意味着每次 Agent 执行完 Bash 命令后,都会自动检查是否有错误需要记录。这对捕获命令行报错非常有效。
Step 4:重启 Gateway
配置完成后,重启使其生效:
全部配置完成后,你的 workspace 目录结构应该大致如下:
当被错误、纠正或功能缺失等事件触发时,Skill 会将格式化的条目写入对应的日志文件。每条记录的结构化字段包括:
- ID:唯一标识
- 时间戳:记录时间
- 优先级:high / medium / low
- 状态:open / resolved / promoted
- 区域标签:归类(如 、、)
- 摘要:一句话描述
- 详情:复现步骤或上下文
- 建议操作:推荐的修复方案
- 元数据:相关文件、标签等
触发场景与写入位置对照:
这是 Self-Improving-Agent 设计中比较精妙的一点:学习记录可以”晋升”。
当某条记录被反复验证、具有广泛适用性时,可以将其从 目录提取出来,晋升到中央项目文件中,使其在所有会话中持久化生效。
晋升前建议确认以下几点:
- ✅ 解决方案已经过测试
- ✅ 描述脱离原始上下文后仍然清晰
- ✅ 代码示例是自包含的
- ✅ 没有项目特定的硬编码值
方式一:手动检查文件
方式二:跟 Agent 对话验证
直接让 Agent 自检:
如果一切正常,Agent 会在 中写入一条测试记录,你可以打开文件确认。
⚠️ Skills 列表中的内容是经过策展的,但并非经过审计的。
它们可能随时被原始维护者更新、修改或替换。在安装或使用任何 Agent Skill 之前:
- 自行审查代码,关注潜在的安全风险
- 验证来源是否可信
- 可以访问 ClawHub 上该 Skill 的页面查看 VirusTotal 扫描报告(OpenClaw 与 VirusTotal 有合作)
openclaw skills 教程
- 不要把 加到
如果是团队项目,学习记录应该被提交到仓库,作为团队共享知识。新成员加入时可以快速了解历史踩坑记录。 - OpenClaw 是主要平台
该 Skill 使用基于 workspace 的 prompt 注入,OpenClaw 会自动加载 skill 文件,无需额外配置加载路径。 - Hook 不是必需的,但强烈建议启用
没有 Hook 时,你需要在对话中主动提醒 Agent “记录一下这个错误”。有了 Hook,Agent 会自动检测并记录,省心很多。 - 定期 Review 学习记录
建议每周花几分钟浏览 下的文件,把有价值的条目晋升到对应的中央文件中。这个习惯会让你的 Agent 随时间变得越来越强。 - 记录的条目格式是标准化的
结构化字段包括 ID、时间戳、优先级、状态、区域、摘要、详情、建议操作、元数据、相关文件和标签,方便后续检索和自动化处理。
整个安装配置过程可以概括为四步:
Self-Improving-Agent 的设计哲学很简单:让 Agent 把每一次失败都变成未来的经验。配置成本极低,但长期收益很高。尤其是在团队场景下,一个人踩过的坑,整个团队的 Agent 都能受益。
如果觉得有帮助,欢迎 点赞 👍 收藏 ⭐ 关注 🔔,有问题评论区见!
本文为原创内容,转载请注明出处。
发布者:Ai探索者,转载请注明出处:https://javaforall.net/254814.html原文链接:https://javaforall.net
