| name | openclaw-soul |
| description | OpenClaw 自我进化框架一键部署。安装宪法 (AGENTS.md)、可进化灵魂 (SOUL.md)、心跳系统、PARA 三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup openclaw-soul"、"安装进化框架"、"部署灵魂系统"、"openclaw-soul"。 |
| metadata | {"clawdbot":{"emoji":"🧬","requires":{"bins":"[Truncated]"},"os":["linux","darwin","win32"]}} |
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 是否存在：
5b. Self-Improving Agent
检查 $WORKSPACE/skills/self-improving/SKILL.md 是否存在：
5c. 验证
安装完成后，验证两个 skill 的 SKILL.md 文件存在且非空。
5d. clawhub 不可用的回退方案
如果 clawhub CLI 不可用：
"clawhub 未找到。请手动安装依赖 skill：
clawhub install evoclawclawhub 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
> 执行模式与习得规则。在修正与教训后更新。
(空 —— 将在使用中累积)
~/self-improving/corrections.md:
# Corrections Log
> 失败的尝试及其修复。每条记录旨在防止同样的错误发生第二次。
(空 —— 将在使用中累积)
~/self-improving/index.md:
# Self-Improving Index
> 所有领域、项目及归档知识的快速参考。
## Domains
(暂无)
## Projects
(暂无)
## Archive
(暂无)
如果文件已存在，不要覆盖 —— 它们可能包含已积累的学习内容。
§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 — 给您的 AI 一个不断进化的灵魂。
