🧠 Agent 自我学习技能

让 Agent 通过分析对话历史，自动提取关键信息并更新配置文件，实现持续自我成长。

通用化设计 | 多平台支持 | 学习记录系统 | Hook 集成

🎯 核心功能

1. 双引擎学习系统 🚀

引擎 A: 配置文件更新 (Memory Update)

• - 分析过去 24 小时的对话内容
• AI 智能判断需要新增、删除还是更新
• 自动更新 8 个核心配置文件

引擎 B: 学习记录系统 (Learning Log)

• - 即时记录用户纠正、错误、功能请求
• 结构化条目 (ID/优先级/状态/分类)
• 支持提升到项目文件 (SOUL.md, AGENTS.md, TOOLS.md)
• Pattern-Key 追踪重复模式

2. 通用化设计 ✅

• - 不局限于特定平台 (OpenClaw/其他)
• 工作目录自动检测
• 配置文件支持
• 环境变量支持

3. 配置文件更新

自动更新 8 个核心配置文件：

• - MEMORY.md - 长期记忆 (必须)
• IDENTITY.md - Agent 身份
• USER.md - 用户信息
• TOOLS.md - 工具配置
• SOUL.md - 人格定义
• AGENTS.md - 使用指南
• BOOTSTRAP.md - 初始化引导
• HEARTBEAT.md - 心跳任务

4. 学习记录文件

自动创建和管理 .learnings/ 目录:

• - LEARNINGS.md - 纠正、知识缺口、最佳实践
• ERRORS.md - 命令失败、异常
• FEATURE_REQUESTS.md - 用户请求的功能

5. 条目 ID 系统

类型	格式	示例
学习	LRN-YYYYMMDD-XXX	LRN-20250115-001
错误

ERR-YYYYMMDD-XXX | ERR-20250115-A3F |

| 功能 | FEAT-YYYYMMDD-XXX | FEAT-20250115-002 |

6. 提升规则 (Promotion)

当学习内容广泛适用时，自动提升到项目文件:

学习类型	提升到	示例
行为模式	SOUL.md	简洁回复，避免免责声明
工作流改进

AGENTS.md | 长任务使用子代理 | | 工具技巧 | TOOLS.md | Git push 需要先配置认证 | | 项目约定 | CLAUDE.md | 使用 pnpm 而非 npm |

7. Hook 集成 🔗

• - onSessionStart: 会话开始时检查待处理高优先级条目
• onPromptSubmit: 检测用户纠正信号，建议记录

8. 企业级特性

• - ✅ 完整的日志系统
• ✅ 执行历史记录
• ✅ 文件验证机制
• ✅ 自动备份与回滚
• ✅ 预览模式
• ✅ 单元测试覆盖
• ✅ 重复模式检测 (Recurrence-Count >= 3 自动提升)

🚀 快速开始

安装

bash

1. 下载技能

git clone https://github.com/Acczdy/self-learning-skill.git cd self-learning-skill

2. 安装依赖

pip install -r requirements.txt

3. 复制配置文件

cp config.yaml config.yaml

4. 初始化学习记录目录 (可选)

python3 scripts/learning_manager.py --init

基本使用

bash

自动检测工作目录并执行学习

python3 scripts/memory_update.py

指定工作目录

python3 scripts/memory_update.py --workspace /path/to/workspace

预览模式 (不实际执行)

python3 scripts/memory_update.py --dry-run

使用自定义配置

python3 scripts/memoryupdate.py --config myconfig.yaml

学习记录命令

bash

添加学习记录

python3 scripts/learning_manager.py add-learning \ --category correction \ --summary 用户纠正了 API 用法 \ --priority high

添加错误记录

python3 scripts/learning_manager.py add-error \ --command git push \ --error permission denied

添加功能请求

python3 scripts/learning_manager.py add-feature \ --capability 支持 Telegram 推送 \ --complexity medium

查看待处理高优先级条目

python3 scripts/learning_manager.py list-pending

检查重复模式

python3 scripts/learning_manager.py check-recurring

Hook 配置 (OpenClaw)

bash

复制 Hook 到 OpenClaw

cp -r hooks/openclaw ~/.openclaw/hooks/self-learning

启用 Hook

openclaw hooks enable self-learning

禁用 Hook

openclaw hooks disable self-learning

📋 执行流程

1. 1. 自动检测工作目录

↓

1. 2. 读取核心配置文件

↓

1. 3. 获取对话历史

↓

1. 4. AI 智能分析

↓

1. 5. 备份配置文件

↓

1. 6. 执行更新操作

↓

1. 7. 验证文件有效性

↓

1. 8. 创建每日记忆

↓

1. 9. 保存执行历史

↓

1. 10. 清理旧备份

↓ 完成 ✅

⚠️ 安全特性

备份保护

• - 更新前自动备份
• 保留 7 天备份
• 最多保留 10 个备份
• 支持手动回滚

文件验证

• - Markdown 语法检查
• 更新后自动验证
• 失败自动回滚

删除保护

• - 删除操作需确认
• 最大删除数量限制
• 删除理由必须明确

📊 输出示例

============================================================
🧠 Agent 自我学习开始 (main)
⏰ 时间：2026-03-05 01:30:00
📁 工作目录：/root/.openclaw/workspace
============================================================

📖 读取配置文件...
✅ 已读取 8 个配置文件

💾 备份配置文件...
💾 已备份到：/root/.openclaw/workspace/.backup/20260305_013000

📝 执行更新...
✅ 完成：MEMORY.md
✅ 完成：TOOLS.md

📅 创建每日记忆...
📜 保存执行历史...
🗑️ 清理旧备份...

============================================================
✅ Agent 自我学习完成 (main)
============================================================

🔧 配置说明

config.yaml

yaml

工作目录

workspace: default: ./workspace auto_detect: true

备份配置

backup: enabled: true retain_days: 7 max_backups: 10

日志配置

logging: enabled: true level: INFO

安全配置

safety: validateafterupdate: true maxdeletecount: 10

📁 项目结构

self-learning-skill/
├── scripts/
│ ├── memory_update.py # 主执行脚本
│ └── publish.sh # 发布脚本
├── tests/
│ └── test_main.py # 单元测试
├── examples/
│ ├── config.minimal.yaml # 最小化配置
│ └── config.full.yaml # 完整配置
├── SKILL.md # Skill 定义
├── README.md # 使用说明
├── config.yaml # 配置文件
├── requirements.txt # Python 依赖
├── LICENSE # MIT 许可证
├── CHANGELOG.md # 更新日志
└── .gitignore # Git 忽略文件

🧪 测试

bash

运行单元测试

python3 -m pytest tests/

运行特定测试

python3 -m pytest tests/test_main.py::TestConfig

📈 版本历史

版本	日期	更新内容
2.0.0	2026-03-05	通用化重构、日志系统、测试覆盖
1.1.0

2026-03-05 | 多 Agent 支持 | | 1.0.0 | 2026-03-05 | 初始版本 |

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. 1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m