Self-Evolution-CN#

多 agent 自我进化系统，自动记录学习、错误和功能需求，支持多 agent 统计和自动提升。

快速开始#

一键配置#

bash

cd ~/.openclaw/skills/self-evolution-cn
./scripts/setup.sh

手动配置#

bash

# 设置共享目录
export SHARED_LEARNING_DIR="/root/.openclaw/shared-learning"
export SHARED_AGENTS="agent1 agent2"

# 创建目录和软链接
mkdir -p "$SHARED_LEARNING_DIR"
cp .learnings/*.md "$SHARED_LEARNING_DIR/"
ln -s "$SHARED_LEARNING_DIR" ~/.openclaw/workspace-agent1/.learnings
ln -s "$SHARED_LEARNING_DIR" ~/.openclaw/workspace-agent2/.learnings

# 启用 hook 和 cron
openclaw hooks enable self-evolution-cn
crontab -e  # 添加：0 0 * * * ~/.openclaw/skills/self-evolution-cn/scripts/trigger-daily-review.sh >> ~/.openclaw/skills/self-evolution-cn/logs/heartbeat-daily.log 2>&1

脚本说明#

脚本功能setup.sh一键配置daily_review.sh自动统计与提升（每日 00:00 执行）trigger-daily-review.shCron 触发脚本activator.sh任务完成后提醒error-detector.sh命令失败时提醒extract-skill.sh提取可重用技能

Hook 集成#

自动识别并记录：

• 用户纠正：检测中文关键词（"不对"、"错了"、"错误"、"不是这样"、"应该是"）和英文关键词（"No, that's wrong"、"Actually"、"should be"）
• 命令失败：检测工具执行失败（非零退出码）和系统级错误（command not found、Permission denied、fatal）
• 知识缺口：检测中文关键词（"我不知道"、"查不到"、"不知道"、"无法找到"、"找不到"）和英文关键词（"I don't know"、"can't find"、"not sure"）
• 更好的方法：检测中文关键词（"更好的方法"、"更简单"、"优化"、"改进"）和英文关键词（"better way"、"simpler"、"optimize"、"improve"）

自动生成元数据：

• Pattern-Key：根据类别自动生成唯一标识（user.correction、knowledge.gap、better.method）
• Area：根据类别自动映射到对应区域（行为准则、工作流、工作流改进）

记录文件：

• LEARNINGS.md：学习记录（用户纠正、知识缺口、更好的方法）
• ERRORS.md：错误记录（命令失败、系统错误）
• FEATURE_REQUESTS.md：功能需求记录

启用：

bash

openclaw hooks enable self-evolution-cn

Hook 事件结构#

Hook 监听 OpenClaw 事件并从正确字段读取数据：

事件读取字段说明message:received``event.context.content用户消息内容tool:after``event.context.output工具执行输出agent:bootstrap``event.context.bootstrapFiles引导文件注入

兼容性： 同时支持 event.message 和 event.toolOutput 旧格式。

常见问题#

Q: 如何手动执行检查？#

A: 直接运行：

bash

bash ~/.openclaw/skills/self-evolution-cn/scripts/daily_review.sh

Q: 如何控制是否启用自动提升？#

A: 设置环境变量 AUTO_PROMOTE_ENABLED：

bash

# 禁用自动提升（仅统计）
AUTO_PROMOTE_ENABLED=false bash ~/.openclaw/skills/self-evolution-cn/scripts/daily_review.sh

# 启用自动提升（默认）
AUTO_PROMOTE_ENABLED=true bash ~/.openclaw/skills/self-evolution-cn/scripts/daily_review.sh

Q: 如何修改共享目录？#

A: 设置环境变量：

bash

export SHARED_LEARNING_DIR="/your/custom/path"

Q: 执行状态和日志在哪里？#

A:

• 状态： $SHARED_LEARNING_DIR/heartbeat-state.json
• 日志： $SHARED_LEARNING_DIR/logs/heartbeat-daily.log

详细文档#

• references/format.md - 记录格式
• references/promotion.md - 提升机制
• references/multi-agent.md - 多 agent 支持
• references/hooks-setup.md - Hook 配置
• references/openclaw-integration.md - OpenClaw 集成
• hooks/openclaw/HOOK.md - Hook 说明

更新#

bash

clawdhub update self-evolution-cn

版本#

当前版本：2.1.1

更新日志#

v2.1.1 (2026-04-18)

• 改进记录反馈：记录完成后自动告知记录的文件名（LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md）
• 修改 recordLearning、recordError、recordFeatureRequest 函数返回文件名
• 更新 HOOK.md 文档：说明自动回复机制

v2.1.0 (2026-04-18)

• 添加英文关键词支持：支持 "No, that's wrong"、"Actually"、"should be"、"I don't know"、"can't find"、"not sure"、"better way"、"simpler"、"optimize"、"improve"
• 添加系统级错误检测：支持 command not found、No such file、Permission denied、fatal
• 添加 FEATURE_REQUESTS.md 支持：新增功能需求记录文件
• 实现 Pattern-Key 自动生成：根据类别自动生成唯一标识（user.correction、knowledge.gap、better.method）
• 实现 Area 自动生成：根据类别自动映射到对应区域（行为准则、工作流、工作流改进）
• 统一 handler.js 和 handler.ts 功能：确保两个文件功能完全一致
• 更新 HOOK.md 文档：添加新功能说明
• 改进记录反馈：记录完成后自动告知记录的文件名（LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md）

v2.0.4 (2026-04-16)

• 修复 detectCorrection 函数：移除 toLowerCase()，中文关键词检测不生效
• 修复 detectKnowledgeGap 函数：移除 toLowerCase()
• 修复 detectBetterMethod 函数：移除 toLowerCase()

v2.0.2 (2026-04-16)

• 修复 skills 目录下的 handler.js，确保发布到 clawhub 的版本包含正确的修复
• 从 event.context.content 读取消息，而非 event.message
• 从 event.context.output 读取工具输出，而非 event.toolOutput

v2.0.1 (2026-04-16)

• 修复 Hook 事件结构读取错误：从 event.context.content 读取消息，而非 event.message
• 修复 Hook 工具输出读取：从 event.context.output 读取，而非 event.toolOutput
• 添加事件结构说明文档
• 向后兼容旧格式

v2.0.0 (2026-04-07)

• 优化提升格式，去除冗余元数据
• 根据 Area 字段自动映射到对应的二级标题
• 修复 Area 字段提取逻辑
• 更新文档说明
• 精简所有说明文档
• 修复 Pattern-Key 匹配逻辑
• 添加无效 Pattern-Key 过滤

v1.0.6 (2026-04-06)

• 初始版本