Unified Self Improving

统一自我进化系统 (Unified Self-Improving)

概述

本技能整合了以下三个自我进化相关技能的核心功能：

整合后的系统保留了各技能的独特功能，同时提供统一的存储架构和触发条件，兼顾结构化可读性与存储效率。

架构

存储层级

命名空间隔离

每个命名空间独立存储，防止数据混淆：

• memory/namespace/{namespace}/hot/
• memory/namespace/{namespace}/warm/
• memory/namespace/{namespace}/cold/

Quick Reference

统一触发条件

自动升级规则

HOT → WARM: 同一学习项被访问/引用 3 次
WARM → COLD: 超过 10 次会话未访问
COLD → HOT: 重新被引用时

存储结构

核心文件

~/.openclaw/workspace/memory/
├── hot/
│   ├── session-{YYYY-MM-DD}-{HHMMSS}.md      # 会话日志（Markdown）
│   ├── session-{YYYY-MM-DD}-{HHMMSS}.jsonl   # 会话日志（JSONL）
│   ├── corrections.md                        # 用户纠正记录
│   ├── errors.md                             # 错误记录
│   └── patterns.md                           # 检测到的模式
├── warm/
│   ├── learnings/                            # 升级的学习项
│   │   └── {namespace}/
│   │       └── {learn-id}.jsonl
│   └── patterns/                             # 累积模式库
│       └── {pattern-id}.jsonl
├── cold/
│   └── archive/                              # 归档学习项
│       └── {namespace}/
│           └── {learn-id}.jsonl
├── namespace/                                # 命名空间隔离
│   ├── {namespace-name}/
│   │   ├── hot/
│   │   ├── warm/
│   │   └── cold/
│   └── _meta/
│       └── namespace-config.json             # 命名空间配置
├── index.jsonl                               # 全局索引（所有层级的快速查询）
└── config.json                               # 系统配置

JSONL 记录格式

{"id": "learn-20260315-001", "namespace": "default", "content": "学习内容", "priority": "high", "status": "active", "access_count": 0, "created_at": "2026-03-15T04:00:00Z", "updated_at": "2026-03-15T04:00:00Z"}

Markdown 日志格式

# 学习记录 - 2026-03-15

## ID: learn-20260315-001
- **优先级**: high
- **状态**: active
- **命名空间**: default
- **内容**: ...
- **创建时间**: 2026-03-15T04:00:00Z
- **更新时间**: 2026-03-15T04:30:00Z

## 访问记录
- 2026-03-15 04:00:00 - 创建
- 2026-03-15 04:25:00 - 引用

工作流

Session Start（会话开始）

1. 加载 memory/index.jsonl 建立全局索引
2. 检查 HOT 层是否有未处理的 corrections 或 patterns
3. 如有需要，从 WARM/COLD 层召回相关历史学习
4. 初始化会话日志文件

# 加载索引
cat ~/.openclaw/workspace/memory/index.jsonl | jq -s 'from_entries'

# 召回相关学习
~/.openclaw/workspace/scripts/self-improving/recall.sh --namespace default --recent 5

During Session（会话期间）

# 记录纠正
~/.openclaw/workspace/scripts/self-improving/log.sh --type correction --content "..." --namespace default

# 记录错误
~/.openclaw/workspace/scripts/self-improving/log.sh --type error --content "..." --namespace default

Session End（会话结束）

1. 合并会话日志到 HOT 层
2. 执行自动升级检查（HOT → WARM）
3. 更新全局索引
4. 清理过期会话（超过 3 次会话的 HOT 内容）

# 会话结束处理
~/.openclaw/workspace/scripts/self-improving/session-end.sh

# 自动升级检查
~/.openclaw/workspace/scripts/self-improving/upgrade.sh

保留的独立接口

self-improving-agent 独特功能

# Promote 学习项
self-improving-agent promote learn-20260315-001 --to warm

# 检测重复模式
self-improving-agent detect-pattern --namespace default

self-improving 独特功能

# 创建命名空间
self-improving namespace create project-alpha

# 手动升级
self-improving upgrade learn-20260315-001 --to warm

# 召回历史
self-improving recall learn-20260301-001

mulch 独特功能

# 构建索引
~/.openclaw/workspace/scripts/mulch/mulch prime

# 查询
~/.openclaw/workspace/scripts/mulch/mulch query "priority:high"

# 批量导入
~/.openclaw/workspace/scripts/mulch/mulch import learnings.jsonl

最佳实践

1. 触发条件选择

• 频繁纠正/错误 → 使用 correction / error 触发，保持在 HOT 层
• 重要学习项 → 使用 session-end 配合高优先级标记
• 重复模式 → 依赖自动模式检测，或手动 pattern-detected

2. 命名空间使用

• 为不同项目/领域创建独立命名空间
• 避免跨命名空间的数据混淆
• 定期清理不再需要的命名空间

# 推荐的命名空间结构
memory/namespace/
├── default/      # 默认通用学习
├── project-x/    # 特定项目学习
├── skill-y/      # 特定技能学习
└── research/     # 研究相关学习

3. 格式选择

4. 性能优化

• 使用 mulch prime 定期更新索引
• 批量操作使用 JSONL 格式
• 定期执行 upgrade.sh 维持层级健康

5. 故障恢复

• HOT 层丢失：可从 WARM 层恢复
• 索引损坏：执行 mulch prime 重建
• 数据不一致：使用 self-improving recall 手动召回

配置示例

{
  "version": "1.0.0",
  "storage": {
    "hot_retention_sessions": 3,
    "warm_retention_sessions": 10,
    "auto_upgrade_threshold": 3,
    "default_namespace": "default"
  },
  "formats": {
    "primary": "jsonl",
    "secondary": "markdown",
    "hot_dual_format": true
  },
  "trigger_conditions": {
    "session_end": true,
    "error": true,
    "correction": true,
    "pattern_detected": true,
    "manual_trigger": true,
    "heartbeat": true
  },
  "heartbeat_interval_minutes": 30
}

文件位置

• 技能目录: ~/.openclaw/workspace/skills/unified-self-improving/
• 存储根目录: ~/.openclaw/workspace/memory/
• 脚本目录: ~/.openclaw/workspace/scripts/self-improving/
• Mulch 脚本: ~/.openclaw/workspace/scripts/mulch/