self-improving-agent 概览
self-improving-agent 会在 .learnings/ 目录中结构化记录错误、修正、缺失能力与更优方案。
通过持续记录与提炼，将重复问题沉淀为长期项目记忆。
工作原理
命令失败、用户纠正、缺失功能、API 错误或发现更优方法时触发。
事件写入 .learnings/ 文件，包含时间、类别、上下文与解决方案。
在重大任务前回顾历史学习，避免重复错误。
确认有效的学习内容会被提炼进 CLAUDE.md、AGENTS.md 等项目记忆文件。
核心功能
错误记录
将命令、工具或 API 错误写入 .learnings/ERRORS.md。
纠错捕捉
当用户纠正输出时记录为 correction 类别。
功能需求跟踪
缺失能力记录到 .learnings/FEATURE_REQUESTS.md。
知识缺口识别
标记知识过时或错误，并记录为 knowledge_gap。
最佳实践沉淀
将更优方案记录为 best_practice。
Markdown 存储
全部记录以 Markdown 存储，便于审阅与版本控制。
OpenClaw 集成
支持 OpenClaw 工作区注入与跨会话共享。
环境要求
- 无需 API Key。
- 无需额外二进制，仅通过文件读写工作。
- 适配 Claude Code、Cursor、Windsurf 等支持 Markdown 指令的代理。
使用场景
跨会话记忆
避免代理在多个会话中反复犯同样的错误。
团队知识库
共享 .learnings/ 文件夹沉淀团队经验。
排错辅助
通过错误日志定位重复问题根因。
持续改进
无需反复手动提示，逐步改善代理行为。
规划参考
通过功能请求记录推动工具改进。
安装方式
npx clawhub@latest install self-improving-agent在终端运行命令，或点击页面顶部安装按钮一键完成。
常见问题
学习记录存在哪里？
存放在 .learnings/ 目录中的 LEARNINGS.md、ERRORS.md 与 FEATURE_REQUESTS.md。
需要 API Key 或外部服务吗？
不需要，本地运行并仅写入 Markdown 文件。
如何提升为长期项目记忆？
确认有效的内容会被写入 CLAUDE.md、AGENTS.md、TOOLS.md 或 SOUL.md。
支持哪些 AI 代理？
任何读取 Markdown 指令的代理都可使用，包括 Claude Code、Cursor、Windsurf。
会记录哪些事件？
失败、纠正、缺失功能、工具/API 错误、知识缺口与更优方案。
条目格式是什么？
统一包含时间、类别、摘要、上下文与建议解决方案。
可以启用会话开始提醒吗？
可以，支持可选的 OpenClaw 启动提醒钩子。