Self Evolution Cn

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

Security Scan

功能与描述大体一致, 但清单与运行时行为有几个不一致和潜在风险（默认写入 /root 路径、未声明的依赖、会自动写入/修改共享文件和可设为 cron 的持久任务），建议在受控环境中审查/调整配置后再启用。

Purpose & Capability

技能的名称与描述（多 agent 自我进化、记录学习/错误/功能需求并自动提升）与代码和文档的功能基本一致：hook 监听事件、写入 LEARNINGS/ERRORS/FEATURE_REQUESTS、每日统计与自动提升。疑点：registry 元数据声明“无需环境变量/二进制”，但脚本和文档显式依赖 openclaw CLI、cron、jq、以及环境变量（SHARED_LEARNING_DIR、AGENT_ID、AUTO_PROMOTE_ENABLED）。这一不一致会误导管理员和自动化审查。

Instruction Scope

SKILL.md 与脚本指示会创建/写入共享目录（默认 /root/.openclaw/shared-learning）、在工作区创建软链接、启用 hook、并建议在 crontab 中添加每日自动执行脚本。handler 会注入虚拟 bootstrap 文件（SELF_EVOLUTION_REMINDER.md）到会话上下文，脚本会追加/修改项目级文件（例如 SOUL.md）在自动提升流程中。虽然这些行为符合“自我进化”目的，但它们涉及 persistent writes、可能修改项目 policy/behavior（SOUL.md）并要求 filesystem and cron access — 用户应明白这些副作用并审查脚本。

Install Mechanism

这是 instruction-only（没有安装规范），源代码和脚本都包含在技能包中；没有外部下载或可疑安装步骤. 优点：无远程提取。注意：scripts 需要被显式运行（./scripts/setup.sh、crontab 条目等），并假定系统提供 openclaw CLI、jq、readlink 等工具，但这些二进制未在注册表元数据中声明。

Credentials

技能不请求任何机密或 API 凭据 (no SECRET/TOKEN/etc)，这是良性信号。风险/不一致点：运行时读取和使用了若干未在元数据中声明的环境变量（SHARED_LEARNING_DIR、AGENT_ID、AUTO_PROMOTE_ENABLED、CLAUDE_TOOL_OUTPUT），并默认使用 /root 路径。读写的位置和权限预期可能会导致意外写入到高权限目录，建议明确设置 SHARED_LEARNING_DIR 到受控位置并验证运行用户权限。

Persistence & Privilege

always: false。技能不会被强制常驻，但它包含脚本/建议（cron 条目、shared-learning 目录、hooks enable）会创建长期存在的 artifacts（共享目录、日志、SOUL.md 修改、crontab 任务）。handler 注入虚拟 bootstrap 文件到 agent 启动上下文，这会影响 agent 行为。没有修改其他技能配置的代码被发现，但自动提升脚本会修改项目级文档（SOUL.md），这一点在授权前应被审查。

Scan Findings in Context

[pre-scan-injection-none] expected: 静态预扫描未报告注入指示或已被标记的恶意模式。代码包含常见文件/FS 操作、正则匹配和 shell 脚本，这是与其目的相符的。

What to consider before installing

要点与建议： - 功能与文档一致：这个技能会监听 agent 事件并把“学习/错误/功能请求”写入共享目录，能按 Pattern-Key 自动统计并在满足条件时修改/追加到 SOUL.md（自动提升）。 - 不一致与风险：注册信息未声明依赖项，但脚本期望 openclaw CLI、jq、cron、readlink 等；默认路径是 /root/.openclaw/shared-learning —— 这可能导致以 root 身份的写入或权限问题。daily_review.sh 会在自动提升启用时修改项目级文件（SOUL.md）；handler 会注入引导内容到会话上下文，这会影响 agent 的行为。 - 建议在启用前采取的步骤： 1) 在受控/测试环境中先运行并逐行审查 scripts/*.sh 和 hooks handler.js/ts； 2) 明确设置 SHARED_LEARNING_DIR 到一个非特权目录（例如 $HOME/.openclaw/shared-learning）并导出 AGENT_ID； 3) 将 AUTO_PROMOTE_ENABLED=false 以禁用自动写入/提升，手动审查统计结果后再开启； 4) 不要盲目运行 ./scripts/setup.sh 或把 trigger-daily-review.sh 放入 crontab，先检查脚本会执行什么（尤其是对 SOUL.md 的写入逻辑）； 5) 确认系统上存在 openclaw、jq 等工具，或在 SKILL 元数据中补充这些依赖信息以便审核； 6) 授权前搜索并确认技能不会写入或追加到任意敏感路径（/etc、/root/以外的关键位置），并确保运行用户权限受限。 - 额外说明：总体上技能行为可被理解为“有用但有侵入性（文件/cron/agent bootstrap 注入）”，在生产环境中应谨慎启用并根据上述建议调整配置后再使用。

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

快速开始

一键配置

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

手动配置

# 设置共享目录
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.sh	Cron 触发脚本
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：功能需求记录

启用：

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 ~/.openclaw/skills/self-evolution-cn/scripts/daily_review.sh

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

A: 设置环境变量 AUTO_PROMOTE_ENABLED：

# 禁用自动提升（仅统计）
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: 设置环境变量：

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 说明

更新

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)

• 初始版本