用途：在命令失败、用户纠正假设、能力缺失或知识过时时，把学习、错误与功能请求记录到项目或工作区根目录的 .learnings/ 中，供后续处理为修复，并把重要学习提升到工作区记忆。
主要能力：首次使用会初始化 .learnings/LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md，不覆盖已有文件。按情境记录：命令失败写入 ERRORS.md；用户纠正写入 LEARNINGS.md 并标 correction；缺失功能写入 FEATURE_REQUESTS.md；集成失败写入 ERRORS.md；知识过时标 knowledge_gap；更好做法标 best_practice。条目使用 TYPE-YYYYMMDD-XXX 编号，可更新状态为 resolved、in_progress、wont_fix、promoted，并附 Resolution 块。通用学习可提升到 SOUL.md、TOOLS.md、AGENTS.md，并保留来源链接。
使用方式：OpenClaw 推荐安装命令 openclaw skills install @pskoett/self-improving-agent；也可用 clawhub install @pskoett/self-improving-agent，或手动复制仓库的 self-improving-agent/ 子文件夹到 ~/.openclaw/skills/self-improving-agent。可选 hook 通过 cp -r ~/.openclaw/skills/self-improving-agent/hooks/openclaw ~/.openclaw/hooks/self-improvement 与 openclaw hooks enable self-improvement 启用，仅在 .learnings/ 存在时运行。
适用场景：需要跨会话积累经验、减少重复错误、记录用户偏好与工具陷阱的 OpenClaw 工作区。
限制：本版本仅适用于 OpenClaw；不记录密钥、令牌、私钥、环境变量或完整源码/配置，除非用户明确要求。hook 只提醒和捕获可能错误，不强制执行流程或重新验证声明。历史观察不会因时间过期，需按 reality、decision、dependency、relevance 类型重新验证；无证据时不得把声明当作已验证。技能创建或修改需明确授权。其他代理请参考原多代理版本。