# Openclaw Soul

> OpenClaw 自我进化框架一键部署。安装宪法 (AGENTS.md)、可进化灵魂 (SOUL.md)、心跳系统、PARA 三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup openclaw-soul"、"安装进化框架"、"部署灵魂系统"、"openclaw-soul"。

- Skill: `lza6/openclaw-soul` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add lza6/openclaw-soul`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lza6/openclaw-soul/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lza6 (https://skillmd.com/u/lza6)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lza6/openclaw-soul

---


# 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 自我进化框架。请确认：
> 1. 工作区路径是什么？（默认：`~/.openclaw/workspace/`）
> 2. 如有自定义路径请告知。"

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

---

## §2 [GATE] 环境检查

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

运行预检脚本：

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

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

1. **工作区目录存在**：`$WORKSPACE` 路径必须存在且可写
2. **openclaw.json 可读**：检查 `$WORKSPACE/../openclaw.json` 是否存在且为有效 JSON
3. **clawhub CLI 可用**：`which clawhub` 或检查 `~/.openclaw/bin/clawhub`
4. **列出已有文件**：检查以下 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`：

```bash
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` |

**部署步骤**：
1. 读取 `references/` 中的模板文件内容
2. 写入对应的 `$WORKSPACE` 目标路径
3. 创建目录结构（如不存在）：
   ```
   $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
   ```
4. 每个文件写入后读回验证——确认文件非空且内容完整

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

---

## §5 [REQUIRED] 依赖 Skill 安装

### 5a. EvoClaw

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

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

### 5b. Self-Improving Agent

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

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

### 5c. 验证

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

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

如果 clawhub CLI 不可用：

> "clawhub 未找到。请手动安装依赖 skill：
> 1. `clawhub install evoclaw`
> 2. `clawhub install self-improving`
> 安装完成后再次运行此 skill 继续配置。"

---

## §6 [REQUIRED] EvoClaw 治理配置

### 6a. 治理配置

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

```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**:
```markdown
# Self-Improving Memory

> 执行模式与习得规则。在修正与教训后更新。

(空 —— 将在使用中累积)
```

**~/self-improving/corrections.md**:
```markdown
# Corrections Log

> 失败的尝试及其修复。每条记录旨在防止同样的错误发生第二次。

(空 —— 将在使用中累积)
```

**~/self-improving/index.md**:
```markdown
# Self-Improving Index

> 所有领域、项目及归档知识的快速参考。

## Domains
(暂无)

## Projects
(暂无)

## Archive
(暂无)
```

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

---

## §8 [REQUIRED] Heartbeat 配置

使用 `openclaw config set` 更新 heartbeat 设置：

```bash
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`：

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

---

## §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 全部通过后才执行此步骤。**

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

> "🧬 openclaw-soul 部署完成！
>
> 已安装：
> - 宪法 (AGENTS.md) — 含 Conductor 协议和委派规范
> - 可进化灵魂 (SOUL.md) — 带版本快照回滚
> - 结构化心跳协议 (HEARTBEAT.md) — 唤醒上下文 + 阻塞去重 + 预算感知
> - PARA 三层记忆 (entities 知识图谱 + daily 日记 + 隐性知识)
> - 目标管理 (GOALS.md) — 任务追溯到目标
> - EvoClaw 治理 (advisory 模式)
> - Self-Improving Agent
>
> 现在开始您的第一次深度对话 —— 我要认识您，然后定义我自己的性格。"

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

---

_openclaw-soul v1.1.0 — 给您的 AI 一个不断进化的灵魂。_