self‑improving‑agent 安装与配置指南（OpenClaw）

本指南提供最稳定、最简洁、完全遵循官方 Skill 设计的安装流程。目标只有一个能记录、能读取、不冲突、不魔改该版本严格遵循self-improving-agentSkill 自带逻辑不添加额外数据库、不增加自定义模板、不引入多余索引文件。一、技能作用self‑improving‑agent 为 OpenClaw 提供三种长期记录能力错误记录 经验学习 功能需求记录记录文件位于/root/.openclaw/workspace/.learnings/包含三个标准日志ERRORS.md LEARNINGS.md FEATURE_REQUESTS.md设计原则凡错必记 记录可查 避免重复错误二、完整安装流程第一步安装 Skill在 OpenClaw 环境中执行clawhubinstallself-improving-agent确认安装成功ls-la/root/.openclaw/workspace/skills/self-improving-agent如果目录存在说明 Skill 已正确安装。第二步初始化学习日志创建学习目录mkdir-p/root/.openclaw/workspace/.learnings创建三个日志文件touch/root/.openclaw/workspace/.learnings/LEARNINGS.mdtouch/root/.openclaw/workspace/.learnings/ERRORS.mdtouch/root/.openclaw/workspace/.learnings/FEATURE_REQUESTS.md注意不要添加自定义表头 不要写入模板 保持文件为空Skill 会按自身格式写入。第三步启用 Hook推荐Hook 用于在新会话时提醒 Agent 检查学习记录。创建 Hook 目录mkdir-p~/.openclaw/hooks复制 Skill 自带 Hookcp-r/root/.openclaw/workspace/skills/self-improving-agent/hooks/openclaw\~/.openclaw/hooks/self-improvement启用 Hookopenclaw hooksenableself-improvement检查 Hook 状态openclaw hooks list如果看到self-improvement Enabled说明 Hook 已正常运行。三、配置 AGENTS.md核心规则编辑文件/root/.openclaw/workspace/AGENTS.md在文件末尾加入### 10. Self-Improvement Workflow 当发生以下情况时必须使用 self-improvement 规则进行记录 - 命令或操作执行失败 - 外部 API 或工具调用失败 - 用户纠正你的回答 - 发现知识过时 - 发现更好的实践 - 用户提出当前不存在的功能需求 记录位置 - 执行错误 → .learnings/ERRORS.md - 经验学习 → .learnings/LEARNINGS.md - 功能需求 → .learnings/FEATURE_REQUESTS.md 记录规范 - **ID 格式**ERR-YYYYMMDD-XXX 或 LRN-YYYYMMDD-XXX - **模板格式**严格遵循 Skill 自带 SKILL.md 中定义的 Entry 模板 复习规则 在执行复杂任务或新任务前应优先检查 .learnings/ 是否存在相关经验。说明AGENTS.md 是 OpenClaw 的最高行为规则。在这里写入规则可以确保 Agent 不会忽略记录。四、验证安装测试错误记录在 OpenClaw 对话中输入请执行命令ls /root/no_dir_test_123 报错后请按 self-improvement 规则写入 .learnings/ERRORS.md 并告诉我生成的 ERR ID。如果 Skill 工作正常ERRORS.md 会新增一条记录检查日志文件执行cat/root/.openclaw/workspace/.learnings/ERRORS.md如果看到包含Logged Priority Area Summary Metadata等字段说明 Skill 正常运行。五、常用维护命令查看最新错误tail-n20/root/.openclaw/workspace/.learnings/ERRORS.md统计待处理学习项grep-cStatus**: pending/root/.openclaw/workspace/.learnings/*.md检查 Hook 状态openclaw hooks list六、避坑指南非常重要避免以下错误操作禁止自创模板不要自己设计 ERR / LRN 表格格式。必须使用 Skill 原生格式。禁止增加 INDEX 文件.learnings目录不需要额外索引。Agent 直接读取 Markdown 即可。禁止自动修改系统规则不要让 Agent 自动修改SOUL.md AGENTS.md TOOLS.md规则升级必须由用户确认。七、总结完成以上配置后OpenClaw 将具备错误记录能力 经验学习能力 长期记忆 避免重复犯错实现AI → 记录 → 学习 → 改进这就是 self‑improving‑agent 的核心价值。