ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

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

为什么你的龙虾装了 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 更适合持续调用。
返回列表