不会复盘的龙虾，养多久都是新手：self-improvement 技能使用指南

养虾圈有句老话：不会复盘的龙虾养多久都是新手。

这句话放在 Agent 使用上同样适用。很多用户安装了 self-improvement 技能，但从来不看 learnings 文件，结果同样的错误犯了一遍又一遍。

今天这篇教程，就是要帮你打破这个循环。

self-improvement 到底是什么

先说人话：self-improvement 就是让 Agent 具备「吃一堑长一智」的能力。

它会自动记录三类信息：执行失败的操作、用户对它的纠正、以及新发现的知识。下次遇到类似场景时，Agent 会主动应用这些经验，避免重复犯错。

很多用户以为安装了技能就万事大吉，其实真正的价值在于后续的回顾和应用。

learnings 文件不是用来收藏的，是用来反复看的。

为什么你必须学会复盘

重复犯错是最浪费时间的事情。

每次让 Agent 执行某个命令都失败，每次都手动纠正，但下次还是同样的错误。

这种循环不仅降低效率，还会让你对 Agent 失去信任。

复盘的核心价值在于打破这个循环。通过记录错误和纠正，Agent 会逐步建立你的个人知识库。

它越来越懂你的习惯，你也不需要反复说明同样的要求。

从另一个角度看，复盘也是加速 Agent 成长的最快路径。每次错误都是一次学习机会。关键在于你能不能把这些零散的经验抽象成可复用的规则，然后应用到新场景中。

安装和配置

安装很简单直接对龙虾说：

1
请帮我安装 self-improvement skill

learnings 文件默认保存在 ~/.openclaw/workspace/notes/learnings.md。记录级别分为三类：error（错误）、correction（纠正）、knowledge（知识更新）。

自动应用功能建议保持启用状态。这样 Agent 在遇到类似场景时会自动应用历史经验，减少你的重复纠正。

启动 self-improvement 的 Hooks

self-improvement 的 Hooks 功能可以在对话中直接开启。

开启方式：

直接对龙虾说：

1
启动 self-improvement 的 Hooks

Agent 就会自动扫描 learnings 文件，提取与当前任务相关的经验，然后主动提醒你。

比如你之前多次遇到 API 限流问题，下次调用 API 时 Agent 会主动说：「根据历史记录，这个 API 有限制，建议添加重试延迟」。

Hooks 的实际效果：

没有 Hooks 时，Agent 只在错误发生后学习。有了 Hooks，Agent 会在错误发生前预防。

什么情况下会触发学习

self-improvement 只在特定场景下触发。

第一类是错误场景。命令执行失败、API 调用错误、权限不足等情况都会被自动记录。

第二类是用户纠正。当你说「不对」「应该是 xxx」「我不喜欢这个格式」时，Agent 会记录你的偏好。

第三类是知识更新。安装新技能、修改配置、发现更好的做法时，这些新信息也会被记录下来。

实战示例

场景一：命令执行失败

你让 Agent 执行 ls -la /root，返回权限不足错误。Agent 会记录：「执行需要 root 权限的命令时，应提醒用户使用 sudo」。下次你再让 Agent 执行类似操作时，它会主动提醒权限问题。

场景二：用户纠正偏好

你说：「不对，我不喜欢用表格总结」。Agent 记录：「用户偏好 - 回复避免使用表格格式」。之后的所有回复都会遵守这个偏好。

场景三：API 限流处理

Agent 调用外部 API 时遇到 429 限流错误。它记录：「外部 API 存在速率限制，需要添加重试延迟和退避策略」。后续所有 API 调用都会自动添加重试机制。

让复盘真正有效的关键动作

定期回顾 learnings 文件

建议每周花 10 分钟扫一眼 learnings 文件。检查有没有重复记录的错误，有没有无效的学习条目。把相似的内容合并，过时的内容删除。

把经验抽象成规则

具体的错误记录价值有限，真正有用的是从错误中抽象出的通用规则。比如从「ls /root 权限不足」抽象出「执行系统命令前检查权限要求」。把这些规则添加到 SOUL.md 或 AGENTS.md 中，形成标准化的操作规范。

区分有效学习和无效学习

偶发的、临时的、特定场景的问题可以过滤掉。聚焦那些可复用、有普遍性的经验。判断标准很简单：这条经验能不能在未来类似场景中应用？

最后说两句

复盘不是目的，成长才是。

self-improvement 技能的价值不在于记录了多少错误，而在于你是否真正从错误中学到了东西，并且在下一次遇到类似场景时能够避免同样的错误。

不会复盘的龙虾养多久都是新手。但会复盘的你，很快就能成为养虾高手。