openclaw-soul — Self-Evolution Framework

为 OpenClaw 安装完整的自我进化框架：宪法 + 可进化灵魂 + 结构化心跳协议 + PARA 三层记忆 + 目标管理 + 治理配置。

安装内容：

9 个工作区文件（AGENTS.md, SOUL.md, HEARTBEAT.md, BOOTSTRAP.md, USER.md, IDENTITY.md, GOALS.md, working-memory.md, long-term-memory.md）
2 个依赖 skill（evoclaw, self-improving）
Heartbeat 定时任务配置
EvoClaw 治理配置（advisory 模式 + soul-revisions 回滚）
PARA 三层记忆目录结构
引导对话启动（BOOTSTRAP.md）

§1 [GATE] 确认安装环境

在执行任何操作之前，必须先完成此步骤。跳过此步骤是禁止的。

询问用户：

"准备部署 openclaw-soul 自我进化框架。请确认：

工作区路径是什么？（默认：~/.openclaw/workspace/）

如有自定义路径请告知。"

将用户确认的路径记为 $WORKSPACE。如果用户说"默认"或不指定，使用 ~/.openclaw/workspace/。

§2 [GATE] 环境检查

必须先通过环境检查，否则禁止继续后续步骤。

运行预检脚本：

python3 "$(dirname "$0")/../scripts/preflight_check.py"

如果脚本不可用，手动执行以下检查：

工作区目录存在：$WORKSPACE 路径必须存在且可写
openclaw.json 可读：检查 $WORKSPACE/../openclaw.json 是否存在且为有效 JSON
clawhub CLI 可用：which clawhub 或检查 ~/.openclaw/bin/clawhub
列出已有文件：检查以下 9 个文件是否已存在于 $WORKSPACE：
- AGENTS.md, SOUL.md, HEARTBEAT.md, BOOTSTRAP.md, GOALS.md
- USER.md, IDENTITY.md, working-memory.md, long-term-memory.md

输出格式：逐项报告 pass/warn/fail，标记需要备份的文件。

判断逻辑：

任何 fail → 报告问题并停止，告知用户如何修复
只有 warn → 告知用户限制，确认是否继续
全部 pass → 继续下一步

§3 [REQUIRED] 备份已有文件

对每个即将部署的文件，如果已存在于 $WORKSPACE：

cp "$WORKSPACE/{filename}" "$WORKSPACE/{filename}.backup.$(date +%Y%m%d-%H%M%S)"

列出所有被备份的文件告知用户。如果没有需要备份的文件，跳过此步骤并告知用户。

保证非破坏性：原文件在备份完成后才会被覆盖。

§4 [REQUIRED] 模板部署

从 references/ 目录读取模板，写入 $WORKSPACE：

模板文件	目标位置
`references/agents-template.md`	`$WORKSPACE/AGENTS.md`
`references/soul-template.md`	`$WORKSPACE/SOUL.md`
`references/heartbeat-template.md`	`$WORKSPACE/HEARTBEAT.md`
`references/bootstrap-guide.md`	`$WORKSPACE/BOOTSTRAP.md`
`references/user-template.md`	`$WORKSPACE/USER.md`
`references/identity-template.md`	`$WORKSPACE/IDENTITY.md`
`references/goals-template.md`	`$WORKSPACE/GOALS.md`
`references/working-memory-template.md`	`$WORKSPACE/working-memory.md`
`references/long-term-memory-template.md`	`$WORKSPACE/long-term-memory.md`

部署步骤：

读取 references/ 中的模板文件内容
写入对应的 $WORKSPACE 目标路径

创建目录结构（如不存在）：

$WORKSPACE/
├── memory/
│   ├── daily/              # Layer 2: daily notes
│   ├── entities/           # Layer 1: knowledge graph
│   ├── experiences/        # EvoClaw
│   ├── significant/        # EvoClaw
│   ├── reflections/        # EvoClaw
│   ├── proposals/          # EvoClaw
│   └── pipeline/           # EvoClaw
└── soul-revisions/         # SOUL.md version snapshots

每个文件写入后读回验证——确认文件非空且内容完整

如果任何文件写入失败，立即停止并报告错误。

§5 [REQUIRED] 依赖 Skill 安装

5a. EvoClaw

检查 $WORKSPACE/skills/evoclaw/SKILL.md 是否存在：

已安装 → 跳过，告知用户
未安装 → 执行：
```
clawhub install evoclaw --force
```
--force 是因为 VirusTotal 可能误报，该 skill 已经过安全审查。

5b. Self-Improving Agent

检查 $WORKSPACE/skills/self-improving/SKILL.md 是否存在：

已安装 → 跳过，告知用户
未安装 → 执行：
```
clawhub install self-improving --force
```

5c. 验证

安装完成后，验证两个 skill 的 SKILL.md 文件存在且非空。

5d. clawhub 不可用的回退方案

如果 clawhub CLI 不可用：

"clawhub 未找到。请手动安装依赖 skill：

clawhub install evoclaw

clawhub install self-improving 安装完成后再次运行此 skill 继续配置。"

§6 [REQUIRED] EvoClaw 治理配置

6a. 治理配置

写入 $WORKSPACE/memory/evoclaw-state.json：

{
  "mode": "advisory",
  "require_approval": ["Core Identity", "Capability Tree", "Value Function"],
  "auto_sections": ["Working Style", "User Understanding", "Evolution Log"],
  "revision_dir": "soul-revisions",
  "initialized": true
}

6b. 验证

确认 evoclaw-state.json 存在且可解析为有效 JSON。

§7 [REQUIRED] Self-Improving Agent 初始化

7a. 目录结构

确保以下目录存在：

~/self-improving/
├── projects/
├── domains/
└── archive/

7b. 初始化文件

如果以下文件不存在，创建初始版本：

~/self-improving/memory.md:

# Self-Improving Memory

> Execution patterns and learned rules. Updated after corrections and lessons.

(empty — will accumulate through use)

~/self-improving/corrections.md:

# Corrections Log

> Failed attempts and their fixes. Each entry prevents the same mistake twice.

(empty — will accumulate through use)

~/self-improving/index.md:

# Self-Improving Index

> Quick reference to all domains, projects, and archived knowledge.

## Domains
(none yet)

## Projects
(none yet)

## Archive
(none yet)

如果文件已存在，不要覆盖——它们可能包含已积累的学习内容。

§8 [REQUIRED] Heartbeat 配置

使用 openclaw config set 更新 heartbeat 设置：

openclaw config set agents.defaults.heartbeat.every "1h"
openclaw config set agents.defaults.heartbeat.target "last"
openclaw config set agents.defaults.heartbeat.directPolicy "allow"

如果 openclaw config set 命令不可用，直接编辑 openclaw.json：

读取当前 openclaw.json
确保 agents.defaults.heartbeat 对象存在
设置：
- every: "1h"
- target: "last"
- directPolicy: "allow"
写回文件

§9 [REQUIRED] 验证清单

逐项检查并报告 pass/fail：

#	检查项	验证方法
1	AGENTS.md 存在且非空	`test -s $WORKSPACE/AGENTS.md`
2	SOUL.md 存在且非空	`test -s $WORKSPACE/SOUL.md`
3	HEARTBEAT.md 存在且非空	`test -s $WORKSPACE/HEARTBEAT.md`
4	BOOTSTRAP.md 存在且非空	`test -s $WORKSPACE/BOOTSTRAP.md`
5	GOALS.md 存在且非空	`test -s $WORKSPACE/GOALS.md`
6	USER.md 存在且非空	`test -s $WORKSPACE/USER.md`
7	IDENTITY.md 存在且非空	`test -s $WORKSPACE/IDENTITY.md`
8	working-memory.md 存在且非空	`test -s $WORKSPACE/working-memory.md`
9	long-term-memory.md 存在且非空	`test -s $WORKSPACE/long-term-memory.md`
10	EvoClaw skill 已安装	`test -f $WORKSPACE/skills/evoclaw/SKILL.md`
11	evoclaw-state.json 配置正确	读取并验证 mode=advisory
12	Self-Improving skill 已安装	`test -f $WORKSPACE/skills/self-improving/SKILL.md`
13	~/self-improving/ 目录就绪	检查 memory.md, corrections.md, index.md
14	Heartbeat 配置已写入	读取 openclaw.json 确认 heartbeat 字段
15	memory/entities/ 目录存在	`test -d $WORKSPACE/memory/entities`
16	memory/daily/ 目录存在	`test -d $WORKSPACE/memory/daily`
17	soul-revisions/ 目录存在	`test -d $WORKSPACE/soul-revisions`

输出格式：

✓ AGENTS.md — pass
✓ SOUL.md — pass
✓ GOALS.md — pass
...
✗ EvoClaw — fail (SKILL.md not found)

判断：

全部 pass → 继续 §10
任何 fail → 列出失败项，提示用户手动修复

§10 [FINAL] 触发引导对话

只有 §9 全部通过后才执行此步骤。

读取 $WORKSPACE/BOOTSTRAP.md
告知用户：

"🧬 openclaw-soul 部署完成！

已安装：

宪法（AGENTS.md）— 含 Conductor 协议和委派规范

可进化灵魂（SOUL.md）— 带版本快照回滚

结构化心跳协议（HEARTBEAT.md）— 唤醒上下文 + 阻塞去重 + 预算感知

PARA 三层记忆（entities 知识图谱 + daily 日记 + 隐性知识）

目标管理（GOALS.md）— 任务追溯到目标

EvoClaw 治理（advisory 模式）

Self-Improving Agent

现在开始你的第一次深度对话——我要认识你，然后定义我自己的性格。"

立即开始执行 BOOTSTRAP.md 的 Phase 1——从这里开始就是 BOOTSTRAP 的流程接管
此 skill 的使命到此结束。后续由 BOOTSTRAP.md + AGENTS.md + SOUL.md 接管运行

openclaw-soul v1.1.0 — Give your AI a soul that grows.

Openclaw Soul