首页/新闻资讯/正文详情

为什么你的龙虾装了 Self-Improving-Agent 却无法自动进化?从 Hook 与 AGENTS.md 配置排查

发布时间:2026/9/27 22:37:41 来源:云帆数科 栏目:资讯中心
为什么你的龙虾装了 Self-Improving-Agent 却无法自动进化?从 Hook 与 AGENTS.md 配置排查
1. 装了技能却没进化断点到底在哪Self-Improving-Agent 是 OpenClaw 生态里的一个元技能作用是让 Agent 把「被纠正、命令失败、知识盲区」这些信号沉淀成可复用的经验条目下次会话再遇到同类问题时不重复踩坑。它适合已经在用 OpenClaw 跑自动化任务、并且希望 Agent 跨会话积累经验的人。但很多人装完之后发现Agent 还是老样子同一个错误犯三次纠正完下次照旧。问题几乎不在技能本身而在两条链路一条是 Hook 触发链路决定「会话启动时有没有人去读历史学习条目」另一条是 AGENTS.md 声明链路决定「Agent 知不知道任务结束后要写学习条目」。这两条链路任意一条断了技能就只是个躺在磁盘上的文件夹不会自动进化。我试过把这两条链路拆开单独验证结论很明确只装技能不初始化.learnings/目录Agent 没有记忆载体只初始化目录不配 Hook会话启动时没人提醒它回顾只配 Hook 不写 AGENTS.mdAgent 根本不知道要记录。三者缺一表现都是「装了等于没装」。下面按排查顺序把可复制的配置和验证动作给全。2. 前置确认技能目录与 Agent 工作空间在动配置之前先把两个路径确认清楚后面所有命令都依赖它们。第一个是技能安装目录第二个是当前 Agent 的工作空间目录。OpenClaw 支持多 Agent每个 Agent 有独立工作空间.learnings/必须建在你实际使用的那个 Agent 目录下建错地方等于没建。# 确认技能是否真的装上了 ls -la ~/.openclaw/skills/self-improving-agent/ # 如果不存在用 ClawHub 安装 clawdhub install self-improving-agent # 列出所有 Agent 工作空间找到你正在用的那个 ls ~/.openclaw/agency-agents/假设你用的是marketing-wechat-operator那工作空间就是~/.openclaw/agency-agents/marketing-wechat-operator/。这里有个高频坑有人把.learnings/建在了~/.openclaw/根目录结果 Agent 在自己的工作空间里找不到自然读不到也写不进。注意技能目录和工作空间目录是两个完全不同的位置。技能是「能力」工作空间是「这个 Agent 的数据」学习记录属于后者。3. 初始化 .learnings 目录记忆载体安装技能不会自动创建日志文件这是 90% 的人漏掉的第一步。Self-Improving-Agent 在.learnings/下维护三个文件LEARNINGS.md存纠正、洞察、知识盲区、最佳实践ERRORS.md存命令失败和集成错误FEATURE_REQUESTS.md存用户请求的新能力。没有这三个文件Agent 就算想记录也无处可写。# 进入你实际使用的 Agent 工作空间 cd ~/.openclaw/agency-agents/marketing-wechat-operator/ # 一键初始化目录与三个日志文件 mkdir -p .learnings [ -f .learnings/LEARNINGS.md ] || printf # Learnings\n\nCorrections, insights, and knowledge gaps.\n\n**Categories**: correction | insight | knowledge_gap | best_practice\n\n---\n .learnings/LEARNINGS.md [ -f .learnings/ERRORS.md ] || printf # Errors\n\nCommand failures and integration errors.\n\n---\n .learnings/ERRORS.md [ -f .learnings/FEATURE_REQUESTS.md ] || printf # Feature Requests\n\nCapabilities requested by the user.\n\n---\n .learnings/FEATURE_REQUESTS.md # 验证 ls -la .learnings/执行完应该看到三个.md文件。这一步做完Agent 才有了「记忆载体」。但载体有了不代表会被读写接下来两条链路才是关键。4. 配置 Hook让会话启动时主动回顾Hook 的作用是在每次会话启动时自动检查.learnings/把未解决的高优先级条目读出来提醒 Agent 参考。没有 HookAgent 不会主动去翻历史记录学习条目就永远躺在文件里。# 从技能目录复制 OpenClaw Hook 模板 cp -r ~/.openclaw/skills/self-improving-agent/hooks/openclaw ~/.openclaw/hooks/self-improvement # 启用 Hook openclaw hooks enable self-improvement # 验证 Hook 已启用 ls -la ~/.openclaw/hooks/如果openclaw hooks enable报「unknown command」说明 OpenClaw 版本过低不支持 Hook先升级npm install -g openclawlatestHook 是可选的但强烈建议开。不开的话你必须在 AGENTS.md 里显式写「任务开始前搜索 .learnings/」靠 Agent 自觉稳定性差很多。5. AGENTS.md 声明让 Agent 知道要记录Hook 解决「读」AGENTS.md 解决「写」。在 Agent 工作空间的AGENTS.md末尾追加工作流声明Agent 才会在任务结束后评估是否记录学习。骨架如下直接复制## Self-Improvement Workflow 任务完成后评估是否需要记录学习 **记录到 .learnings/LEARNINGS.md** 1. 用户纠正了你不对应该是... 2. 发现了更好的方法 3. 知识盲区被填补 **记录到 .learnings/ERRORS.md** 4. 命令执行失败 5. API 调用出错 6. 集成问题 **记录到 .learnings/FEATURE_REQUESTS.md** 7. 用户请求不存在的功能 **促进到永久记忆** 8. 同一模式出现 3 次以上 → 提升到 SOUL.md 或 TOOLS.md ## Memory Recall 任务开始前搜索 .learnings/ 中的相关条目。如果你还想让 Agent 在「被纠正后立即记录」可以在SOUL.md的关键规则部分补一条每次任务后自问「这个经验值得记录吗」被用户纠正后立即写入LEARNINGS.md成熟流程成功 3 次以上请求提升到SOUL.md。6. 验证 Hook 是否真的唤醒 Agent配置完不能只看文件在不在要验证触发链路真的通了。分三步# 第一步确认 Hook 目录结构正确 find ~/.openclaw/hooks/self-improvement -type f # 第二步手动往 ERRORS.md 写一条测试条目 cat ~/.openclaw/agency-agents/marketing-wechat-operator/.learnings/ERRORS.md EOF ## [2025-01-01] Test entry - **Status**: open - **Context**: hook verification - **Detail**: 这是一条用于验证 Hook 是否读取的测试条目 EOF # 第三步启动一个新会话观察启动输出 openclaw chat --agent marketing-wechat-operator如果 Hook 生效新会话启动时应该能看到系统提示里带出这条 open 状态的测试条目。看不到就回到第 4 步检查 Hook 是否 enable 成功。验证完记得把测试条目删掉或标记Status: resolved。7. 本篇常见错排查Hook 不生效先openclaw hooks list看 self-improvement 是否在启用列表里。不在就重新 enable在但没输出检查 Hook 脚本里的路径是不是写死了别的 Agent 名。学习条目没被参考确认 AGENTS.md 里有Memory Recall段或者 Hook 已启用。两者都没有Agent 不会主动读。文件越写越乱没有定期整理。建议每周花 10 分钟把已解决的条目标Status: resolved成熟条目提升到SOUL.md/TOOLS.md删掉过时内容。不知道工作空间路径ls ~/.openclaw/agency-agents/列出来进你实际用的那个。别在根目录建.learnings/。跨设备同步想同步学习记录可以配 cron 定时提交但前提是工作空间已初始化 Git 仓库并配好远程0 * * * * cd ~/.openclaw/agency-agents/marketing-wechat-operator git add .learnings/ git commit -m Auto-commit learnings git push8. 配置检查清单与下一步逐项打勾.learnings/目录已创建LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md三个文件已初始化Hook 脚本已复制并 enableAGENTS.md已追加 Self-Improvement Workflow 与 Memory Recall可选 Git 自动提交已配。全部打勾后你的 OpenClaw 才真正具备自我进化能力。自动进化不是装一个技能就有的是配置出来的。如果你在接入过程中需要统一管理模型调用和 Key可以到 TaoToken API Keys 生成密钥接入方式参考 TaoToken 接入文档。想先验证模型对话效果直接开 模型对话 试一轮。长期跑编码和 Agent 任务的话Coding Plan 更适合持续调用。

相关推荐

3个真实网站改版方案案例,新手入门必看的避坑指南
3个真实网站改版方案案例,新手入门必看的避坑指南

3个真实网站改版方案案例,新手入门必看的避坑指南 改个需求建站公司拖一周,改个颜色还要加钱?这是很多新手入门时最崩溃的体验。你以为改版只是换个皮肤,结果对方拿着一堆技术名词跟你扯皮,周期从两周拖到两个月,钱花了不少,效果却像没变过。… · 2026/9/27 22:37:35

AI购物代理开始结账:企业网站,AI买家真的走得通吗
AI购物代理开始结账:企业网站,AI买家真的走得通吗

过去两年,企业做GEO(生成式引擎优化)大多在解决一个问题:内容能不能被AI搜索引用、提到。但2026年9月的最新数据显示,AI已经不只是"提到"品牌,而是开始替用户完成真实购买——PYMNTS Intelligenc… · 2026/9/27 22:37:29

OpenClaw 小龙虾最实用 Skill 技能推荐:TaoToken 统一 Key 接入办公自动化实战(小白必备)
OpenClaw 小龙虾最实用 Skill 技能推荐:TaoToken 统一 Key 接入办公自动化实战(小白必备)

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 22:37:29

TrOCR微调实战:圆形印章检测识别全流程解析
TrOCR微调实战:圆形印章检测识别全流程解析

简介:面向企业文档自动化与电子签章核验场景,这份基于预训练模型微调的端到端公章识别系统资料,适合有一定深度学习基础、希望实现圆形印章检测与印文识别的开发者或学习者。资源共二十八个文件,以Python脚本为核心,覆… · 2026/9/27 23:10:48

VOC转YOLO船只检测数据集:格式转换与训练避坑指南
VOC转YOLO船只检测数据集:格式转换与训练避坑指南

简介:面向计算机视觉研究人员、算法工程师与海事应用开发者,船只检测数据集聚焦船舶目标检测任务,覆盖海洋监控、航海安全、港口管理等实际应用场景,包含多种角度拍摄的船只图片,有助于模型适应视角变化、光照波动与遮… · 2026/9/27 23:10:48

机会约束编程与样本平均近似:Matlab代码实战与避坑指南
机会约束编程与样本平均近似:Matlab代码实战与避坑指南

简介:针对机会约束优化问题的样本平均近似求解,这套Matlab代码提供了完整实现。机会约束优化允许约束在特定置信水平下成立,而SAA通过随机抽样将其转化为可解的确定性优化问题,代码正是围绕这一思路编写,适合计算机、电… · 2026/9/27 23:10:48

VOC转YOLO:船只检测数据集格式转换与训练避坑指南
VOC转YOLO:船只检测数据集格式转换与训练避坑指南

简介:包含VOC与YOLO两种标注格式的船只检测数据集,聚焦海洋监控、航海安全与港口管理等场景中的目标识别问题,适合计算机视觉研究者、算法工程师用于模型训练与效果验证。资源包内共25683个文件,其中8561张jpg原图与8561份xml&… · 2026/9/27 23:10:48

Django+Echarts招聘数据可视化:从数据建模到交互看板实战
Django+Echarts招聘数据可视化:从数据建模到交互看板实战

简介:这是围绕招聘数据可视化分析场景的 Django/Python 项目源码包,适合 Web 开发与数据分析初学者,完整覆盖数据抓取、清洗、统计、接口封装到 ECharts 动态图表展示的实现链路。包内共 165 个文件,以 JavaScript、JSON、Python、… · 2026/9/27 23:10:48

深度学习工业缺陷检测全流程:数据标注、模型训练与产线落地
深度学习工业缺陷检测全流程:数据标注、模型训练与产线落地

简介:面向制造业产线质量控制和自动化检测场景的工业缺陷检测系统资料包,基于深度学习视觉识别算法,覆盖卷积神经网络模型训练、高精度图像处理与异常检测流程,适合算法工程师、产线质检人员以及相关专业学习者用来搭建缺陷识别原… · 2026/9/27 23:10:42

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码