back
loading skill details...
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、六层记忆架构、目标管理、思维方法论（HDD/SDD）、安全审查（skill-vetter），并通过场景化对话引导用户定义 Agent 性格。用户可选安装 EvoClaw（审批制进化）、Self-Impr...
---
name: openclaw-soul
description: OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、六层记忆架构、目标管理、思维方法论（HDD/SDD）、安全审查（skill-vetter），并通过场景化对话引导用户定义 Agent 性格。用户可选安装 EvoClaw（审批制进化）、Self-Improving Agent（自主学习）等依赖 Skill。触发场景：(1) 用户说"灵魂框架"、"部署灵魂"、"部署灵魂系统" (2) 用户说"BOOTSTRAP"、"首次对话"、"第一次对话" (3) 用户说"安装进化框架"、"部署进化框架" (4) 用户提到"openclaw-soul"。注意：这是 OpenClaw 部署的第一步，完成后会引导使用 openclaw-setup 配置技术参数。
metadata:
clawdbot:
emoji: "🧬"
requires:
bins: []
os: ["linux", "darwin", "win32"]
---
# openclaw-soul — Self-Evolution Framework
为 OpenClaw 安装完整的自我进化框架：宪法 + 可进化灵魂 + 结构化心跳协议 + 六层记忆 + 思维方法论 + 跨会话存档 + 目标管理 + 治理配置。
**安装内容**：
- 9 个工作区文件（AGENTS.md, SOUL.md, HEARTBEAT.md, BOOTSTRAP.md, USER.md, IDENTITY.md, GOALS.md, working-memory.md, long-term-memory.md）
- 5 个可选依赖 skill（evoclaw, self-improving, skill-vetter, hdd, sdd）
- 2 个记忆基础设施脚本（merge-daily-transcript.js, auto-commit.sh）
- **动态人格系统**（user-observation hook + 角色推理逻辑）
- Heartbeat 定时任务配置
- EvoClaw 治理配置（advisory 模式 + soul-revisions 回滚）
- 六层记忆目录结构 + Git 版本管理
- 向量搜索配置引导
- 引导对话启动（BOOTSTRAP.md）
---
## §1 [GATE] 环境检测
**在执行任何操作之前，必须先完成此步骤。跳过此步骤是禁止的。**
### 1a. 自动检测工作区
自动检测 `~/.openclaw/workspace/` 是否存在：
```bash
WORKSPACE="$HOME/.openclaw/workspace"
test -d "$WORKSPACE" && echo "WORKSPACE=$WORKSPACE — OK" || echo "FAIL: $WORKSPACE not found"
```
- **存在** → 设置 `$WORKSPACE`，无需任何用户交互，直接继续
- **不存在** → 报错并停止：
> "工作区 `~/.openclaw/workspace/` 不存在。请先确认 OpenClaw 已正确安装，或手动创建该目录后重新触发。"
### 1b. 权限等级检查
**检查当前 OpenClaw 的权限等级，避免后续操作频繁弹出授权确认。**
```bash
# 读取当前权限等级
openclaw config get agents.defaults.permissions 2>/dev/null || echo "NOT_SET"
```
权限等级说明：
| 等级 | 含义 | 适用场景 |
|------|------|---------|
| `restricted` | 每个文件操作都需要授权 | 生产环境、高安全要求 |
| `standard` | 工作区内操作自动授权，工作区外需确认 | 日常使用（推荐） |
| `elevated` | 大部分操作自动授权，仅危险操作需确认 | 开发调试 |
**判断逻辑**：
- 权限等级为 `standard` 或 `elevated` → 继续
- 权限等级为 `restricted` 或未设置 → 使用 `AskUserQuestion` 询问用户：
**问题**："当前权限等级较低，灵魂框架部署需要大量文件操作（复制模板、创建目录、写入配置等），低权限下每一步都会弹出授权确认，体验会很差。建议提升权限等级。"
**选项**：
1. **设置为 standard（推荐）**
- 说明：工作区（`~/.openclaw/workspace/`）内的操作自动授权，工作区外的操作仍需确认。安全性和便利性的平衡点。
- 设置方式：`openclaw config set agents.defaults.permissions "standard"`
2. **设置为 elevated**
- 说明：大部分操作自动授权，仅删除文件、修改系统配置等危险操作需要确认。适合信任环境下的快速部署。
- 设置方式：`openclaw config set agents.defaults.permissions "elevated"`
3. **保持当前等级，继续部署**
- 说明：保持低权限，每一步操作都需要你手动授权确认。操作会多一些，但完全在你的控制下。
用户选择 1 或 2 → 执行对应的 `openclaw config set` 命令，确认生效后继续
用户选择 3 → 继续部署（提醒用户后续会有较多授权确认）
### 1c. 环境检查
1. **openclaw.json 可读**：检查 `$WORKSPACE/../openclaw.json` 是否存在且为有效 JSON
2. **clawhub CLI 可用**：`which clawhub` 或检查 `~/.openclaw/bin/clawhub` 或 `/usr/local/bin/clawhub` 或 `/usr/bin/clawhub`
3. **列出已有文件**：检查以下 9 个文件是否已存在于 `$WORKSPACE`：
- AGENTS.md, SOUL.md, HEARTBEAT.md, BOOTSTRAP.md, GOALS.md
- USER.md, IDENTITY.md, working-memory.md, long-term-memory.md
**判断逻辑**：
- openclaw.json 不存在或无效 → **停止**，告知用户修复
- clawhub 不可用 → 使用 `AskUserQuestion` 让用户选择（见下方）
- 已有文件 → 标记需要备份，继续
**如果 clawhub 不可用**，使用 `AskUserQuestion` 询问用户：
**问题**："未检测到 clawhub（OpenClaw 技能包管理器）。你希望怎么处理？"
**选项**：
1. **先去安装 clawhub，装好后继续**
- 说明：运行 `npm install -g clawhub` 安装。clawhub 的优势：skill 可通过 `clawhub update` 统一更新版本，支持在线搜索和安装社区 skill，依赖管理更规范。安装好后告诉我"装好了"即可继续。
2. **跳过，使用离线方式安装**
- 说明：直接从本 skill 自带的 fallback 文件复制安装。功能完全一样，但后续无法通过 clawhub 统一更新，需要手动管理 skill 版本。如果你只是想快速跑起来，选这个就行。
用户选择 1 → 暂停部署，等待用户安装完成后继续
用户选择 2 → 标记 `CLAWHUB_AVAILABLE=false`，继续部署
### 1d. 开场状态提示
环境检查通过后，输出：
> "我正在帮你做初始化部署，需要装一些核心文件和配置，大概几分钟的时间。你先等我一下，完成了我会通知你。
>
> 部署完之后，我们就开始认识彼此。"
---
## §2 [REQUIRED] 部署文件
**使用 bash cp 部署所有文件。禁止使用 Write/Edit 工具写入模板内容——大文件容易被截断或出错。`cp` 是操作系统级字节复制，100% 可靠。**
### 2a. 获取 skill 目录路径
```bash
# 获取本 skill 的安装路径
SKILL_DIR="$WORKSPACE/skills/openclaw-soul"
# 如果 skill 不在 workspace/skills/ 下，尝试其他常见路径
test -d "$SKILL_DIR" || SKILL_DIR="$(find ~/.openclaw -path '*/openclaw-soul/references' -type d 2>/dev/null | head -1 | sed 's|/references$||')"
echo "SKILL_DIR=$SKILL_DIR"
```
确认 `$SKILL_DIR/references/` 目录存在且包含模板文件。如果找不到，报错停止。
### 2b. 备份已有文件 + 复制模板
```bash
# 备份已有文件
for file in AGENTS.md SOUL.md HEARTBEAT.md BOOTSTRAP.md USER.md IDENTITY.md GOALS.md working-memory.md long-term-memory.md; do
[ -f "$WORKSPACE/$file" ] && cp "$WORKSPACE/$file" "$WORKSPACE/$file.backup.$(date +%Y%m%d-%H%M%S)"
done
# 复制 9 个模板文件
cp "$SKILL_DIR/references/agents-template.md" "$WORKSPACE/AGENTS.md"
cp "$SKILL_DIR/references/soul-template.md" "$WORKSPACE/SOUL.md"
cp "$SKILL_DIR/references/heartbeat-template.md" "$WORKSPACE/HEARTBEAT.md"
cp "$SKILL_DIR/references/bootstrap-guide.md" "$WORKSPACE/BOOTSTRAP.md"
cp "$SKILL_DIR/references/user-template.md" "$WORKSPACE/USER.md"
cp "$SKILL_DIR/references/identity-template.md" "$WORKSPACE/IDENTITY.md"
cp "$SKILL_DIR/references/goals-template.md" "$WORKSPACE/GOALS.md"
cp "$SKILL_DIR/references/working-memory-template.md" "$WORKSPACE/working-memory.md"
cp "$SKILL_DIR/references/long-term-memory-template.md" "$WORKSPACE/long-term-memory.md"
cp "$SKILL_DIR/references/memory-architecture-template.md" "$WORKSPACE/memory/ARCHITECTURE.md"
```
### 2c. 创建目录结构 + 部署脚本 + 动态人格系统
```bash
# 创建六层记忆目录 + EvoClaw 目录 + 脚本目录 + soul-revisions + metadata
mkdir -p "$WORKSPACE/memory/"{daily,entities,transcripts,projects,voice,experiences,significant,reflections,proposals,pipeline,metadata}
mkdir -p "$WORKSPACE/scripts"
mkdir -p "$WORKSPACE/soul-revisions"
mkdir -p "$WORKSPACE/hooks"
# 复制记忆基础设施脚本
cp "$SKILL_DIR/fallback/memory-deposit/scripts/merge-daily-transcript.js" "$WORKSPACE/scripts/"
cp "$SKILL_DIR/fallback/memory-deposit/scripts/auto-commit.sh" "$WORKSPACE/scripts/"
chmod +x "$WORKSPACE/scripts/auto-commit.sh"
# 部署动态人格系统 Hook
if [ -d "$SKILL_DIR/references/hooks/user-observation" ]; then
cp -r "$SKILL_DIR/references/hooks/user-observation" "$WORKSPACE/hooks/"
echo "✓ 动态人格观察 Hook 已部署"
fi
# 追加动态人格规则到 AGENTS.md
if [ -f "$SKILL_DIR/references/dynamic-personality-addon.md" ]; then
cat "$SKILL_DIR/references/dynamic-personality-addon.md" >> "$WORKSPACE/AGENTS.md"
echo "✓ 动态人格规则已添加到 AGENTS.md"
fi
```
### 2d. 验证部署
```bash
# 验证所有文件非空
for file in AGENTS.md SOUL.md HEARTBEAT.md BOOTSTRAP.md USER.md IDENTITY.md GOALS.md working-memory.md long-term-memory.md; do
test -s "$WORKSPACE/$file" && echo "OK: $file" || echo "FAIL: $file is empty or missing"
done
```
如果任何文件验证失败，立即停止并报告错误。
---
## §3 [REQUIRED] 引导对话（BOOTSTRAP）
**核心文件部署完成后，立即进入人格设定对话。这是整个流程中最重要的环节——先让用户定义 AI 的灵魂，再处理技术配置。**
### 3a. 触发引导对话
1. 读取 `$WORKSPACE/BOOTSTRAP.md`
2. 告知用户：
> "核心文件已部署完成！
>
> 接下来我们先聊一聊，分三步：
> 1. **认识你** — 了解你是谁，在做什么，需要什么帮助
> 2. **定义我的性格** — 通过场景问答，选择我的沟通风格
> 3. **确认身份** — 给我起个名字
>
> 这次对话会塑造我的灵魂（SOUL.md），之后我就能按你的方式工作了。
>
> 聊完之后，我再帮你装依赖 Skill 和配置系统。"
3. **立即开始执行 BOOTSTRAP.md 的 Phase 1**
4. **BOOTSTRAP 完成后的收尾与过渡**（这一步是强制的，不能跳过）
BOOTSTRAP 对话自然结束后（AI 已经有了名字、性格、了解了用户），**必须立即执行以下收尾动作，然后主动过渡到 §4**：
**收尾动作**（静默执行，不需要逐步告知用户）：
- 验证 SOUL.md 的 Core Identity 已写入真实内容（不再是占位符）
- 验证 USER.md 已更新用户信息
- 验证 IDENTITY.md 已写入 AI 的名字和角色定位
- 删除 `$WORKSPACE/BOOTSTRAP.md`（引导已完成，不再需要）
- 更新 `working-memory.md`，记录 BOOTSTRAP 完成状态
- 执行 `cd $WORKSPACE && git add -A && git commit -m "bootstrap: 完成首次对话，建立身份"`
**过渡话术**（用 AI 自己的性格和语气说，不要机械照搬）：
大意是："认识完了，接下来帮你把系统配置做完——要装几个可选的能力模块（Skill），配置一些系统参数，几分钟就好。"
然后**立即开始执行 §4**，不要等用户回复。
---
## §4 [REQUIRED] 依赖 Skill 安装（用户确认 + 两级 Fallback）
### 4a. 检查 clawhub 可用性与已安装 Skill
```bash
which clawhub || test -f ~/.openclaw/bin/clawhub
CLAWHUB_AVAILABLE=$?
# 检查哪些 skill 已安装
for skill in evoclaw self-improving skill-vetter hdd sdd; do
test -f "$WORKSPACE/skills/$skill/SKILL.md" && echo "INSTALLED: $skill" || echo "NOT_INSTALLED: $skill"
done
```
### 4b. 展示 Skill 清单并让用户选择
**在安装任何 skill 之前，必须先向用户展示完整清单，说明每个 skill 的用途，让用户确认要安装哪些。**
使用 `AskUserQuestion` 向用户展示以下信息并让用户多选：
**问题**："以下是灵魂框架的可选依赖 Skill，请选择要安装的："
**选项**（multiSelect: true）：
1. **EvoClaw — 审批制进化治理**（推荐）
- 说明：AI 的 Identity/性格/价值观变更需要你批准才能生效，防止 AI 随意修改自己的灵魂。每次变更自动快照到 soul-revisions/，支持回滚。**这是灵魂框架的核心守护机制。**
2. **Self-Improving — 自主学习 Agent**（推荐）
- 说明：AI 从你的纠正和反馈中自动学习规则，持久化到记忆中。下次遇到类似场景会自动应用，不需要你重复纠正。30 天未使用的规则自动归档。
3. **Skill Vetter — 安全审查**
- 说明：在安装新 Skill 前自动执行安全审查，检查 Skill 的权限需求、文件访问范围、网络请求等，防止恶意或有风险的 Skill 进入系统。
4. **HDD — 假设驱动开发**
- 说明：一种思维方法论。面对不确定性时，先提出假设，设计最小实验验证，快速迭代。适合探索性任务和问题诊断。
5. **SDD — 场景驱动开发**
- 说明：一种思维方法论。从具体使用场景出发设计方案，确保每个功能都有真实场景支撑，避免过度设计。
**对已安装的 skill，在选项描述中标注"（已安装，会跳过）"。**
### 4c. 按用户选择安装
对用户选中的每个 skill，按优先级尝试安装（已安装的跳过）：
1. **Level 1 - clawhub 安装**（如果 clawhub 可用）
```bash
clawhub install <skill-name> --force
```
2. **Level 2 - 离线 Fallback**（如果 Level 1 失败或 clawhub 不可用）
```bash
cp -r "$SKILL_DIR/fallback/<skill-name>" "$WORKSPACE/skills/"
```
3. **安装失败处理**（如果 Level 1 和 Level 2 都失败）
- 告知用户安装失败，建议去 GitHub 搜索对应 skill 手动安装
- 提供搜索建议：`https://github.com/search?q=openclaw+<skill-name>`
- 记录警告，继续安装其他 skill
### 4d. 验证结果
安装完成后，逐项报告用户选中的 skill 的安装结果：
```
✓ EvoClaw: [installed from clawhub | installed from fallback | ⚠️ failed | skipped (not selected)]
✓ Self-Improving: [installed from clawhub | installed from fallback | ⚠️ failed | skipped (not selected)]
✓ Skill Vetter: [installed from clawhub | installed from fallback | ⚠️ not installed | skipped (not selected)]
✓ HDD: [installed from clawhub | installed from fallback | ⚠️ not installed | skipped (not selected)]
✓ SDD: [installed from clawhub | installed from fallback | ⚠️ not installed | skipped (not selected)]
```
---
## §5 [REQUIRED] 配置系统
### 5a. EvoClaw 治理配置
写入 `$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
}
```
验证 JSON 可解析。
### 5b. Self-Improving Agent 初始化
确保目录和文件存在：
```bash
mkdir -p ~/self-improving/{projects,domains,archive}
```
如果以下文件**不存在**，创建初始版本（已存在则不覆盖）：
**~/self-improving/memory.md**:
```markdown
# Self-Improving Memory
> Execution patterns and learned rules. Updated after corrections and lessons.
(empty — will accumulate through use)
```
**~/self-improving/corrections.md**:
```markdown
# Corrections Log
> Failed attempts and their fixes. Each entry prevents the same mistake twice.
(empty — will accumulate through use)
```
**~/self-improving/index.md**:
```markdown
# Self-Improving Index
> Quick reference to all domains, projects, and archived knowledge.
## Domains
(none yet)
## Projects
(none yet)
## Archive
(none yet)
```
### 5c. 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`，确保 `agents.defaults.heartbeat` 包含 `every: "1h"`, `target: "last"`, `directPolicy: "allow"`。
### 5d. 向量搜索配置
**没有向量搜索的记忆系统是摆设。此步骤不可跳过。**
1. 执行 `memory_search(query="test memory recall")` 检测当前状态
2. **有结果** → embedding 已就绪，跳到配置 extraPaths
3. **报错或无结果** → 需要配置 embedding provider
向用户说明并推荐方案：
> "向量搜索需要一个 embedding API key，这是记忆系统的核心能力。"
| 方案 | 模型 | 价格 | 说明 |
|------|------|------|------|
| **Gemini** | `gemini-embedding-001` | 免费额度大 | 配置最简单 |
| **硅基流动 SiliconFlow** | `BAAI/bge-large-zh-v1.5` 或 `BAAI/bge-m3` | 免费（注册送额度） | 中文效果好，OpenAI 兼容接口 |
| **OpenAI** | `text-embedding-3-small` | 付费 | 效果稳定 |
硅基流动配置示例（provider 设为 openai，用自定义 baseUrl）：
```json5
memorySearch: {
provider: "openai",
model: "BAAI/bge-large-zh-v1.5",
remote: {
baseUrl: "https://api.siliconflow.cn/v1",
apiKey: "<用户的 SiliconFlow API Key>"
}
}
```
确认用户选定方案后，用 `gateway(action=config.patch)` 或直接编辑 `openclaw.json` 配好。
配置 extraPaths：
```json5
memorySearch: {
extraPaths: ["memory/transcripts", "memory/projects", "AGENTS.md"]
}
```
开启高级搜索功能：
```json5
{
"agents": {
"defaults": {
"memorySearch": {
"query": {
"hybrid": {
"mmr": { "enabled": true, "lambda": 0.7 },
"temporalDecay": { "enabled": true, "halfLifeDays": 30 }
}
},
"cache": { "enabled": true, "maxEntries": 50000 }
}
}
}
}
```
验证：再次执行 `memory_search(query="test")` 确认可用。如果 memory/ 下还没有文件，告知用户："向量搜索已就绪，等积累了笔记后就能搜到了。"
### 5e. Git 版本管理初始化
检查 `$WORKSPACE/.git/` 是否存在：
**不存在** →
```bash
cd $WORKSPACE && git init
```
写入 `.gitignore`（排除敏感文件和临时文件）：
```
.env*
*.secrets
credentials.json
tmp/
node_modules/
.DS_Store
```
执行首次提交：
```bash
git add -A && git commit -m "init: openclaw-soul workspace"
```
**已存在** → 检查 `.gitignore` 包含上述排除项，缺的补上。
---
## §6 [FINAL] 验证 + 激活
### 6a. 核心验证清单（10 项）
逐项检查并报告 pass/fail：
| # | 检查项 | 验证方法 |
|---|--------|---------|
| 1 | AGENTS.md 非空 | `test -s $WORKSPACE/AGENTS.md` |
| 2 | SOUL.md 非空 | `test -s $WORKSPACE/SOUL.md` |
| 3 | BOOTSTRAP.md 非空 | `test -s $WORKSPACE/BOOTSTRAP.md` |
| 4 | USER.md 非空 | `test -s $WORKSPACE/USER.md` |
| 5 | IDENTITY.md 非空 | `test -s $WORKSPACE/IDENTITY.md` |
| 6 | EvoClaw 已安装 | `test -f $WORKSPACE/skills/evoclaw/SKILL.md` |
| 7 | Self-Improving 已安装 | `test -f $WORKSPACE/skills/self-improving/SKILL.md` |
| 8 | evoclaw-state.json 有效 | 读取并验证 `mode=advisory` |
| 9 | Heartbeat 配置已写入 | 读取 openclaw.json 确认 heartbeat 字段 |
| 10 | Git 已初始化 | `test -d $WORKSPACE/.git` |
**输出格式**：
```
✓ AGENTS.md — pass
✓ SOUL.md — pass
✓ BOOTSTRAP.md — pass
✓ USER.md — pass
✓ IDENTITY.md — pass
✓ EvoClaw — pass (installed from fallback)
✓ Self-Improving — pass (installed from fallback)
✓ evoclaw-state.json — pass
✓ Heartbeat — pass
✓ Git — pass
```
**判断**：
- 全部 pass → 继续执行 §7 激活系统
- 任何 fail → 列出失败项，提示用户手动修复
---
## §7 [ACTIVATION] 激活系统
**BOOTSTRAP 对话完成后，必须执行此步骤才能让系统真正"活起来"。**
### 8a. 配置自动加载
确保每次对话都自动加载核心文件到 system prompt：
```bash
# 方法 1: 使用 openclaw config（推荐）
openclaw config set agents.defaults.systemPrompt.files '["~/.openclaw/workspace/AGENTS.md","~/.openclaw/workspace/SOUL.md","~/.openclaw/workspace/IDENTITY.md","~/.openclaw/workspace/GOALS.md"]'
# 方法 2: 如果 config 命令不可用，直接编辑 openclaw.json
```
如果 `openclaw config` 不可用，读取 `$WORKSPACE/../openclaw.json`，在 `agents.defaults` 中添加：
```json
{
"agents": {
"defaults": {
"systemPrompt": {
"files": [
"~/.openclaw/workspace/AGENTS.md",
"~/.openclaw/workspace/SOUL.md",
"~/.openclaw/workspace/IDENTITY.md",
"~/.openclaw/workspace/GOALS.md"
]
}
}
}
}
```
验证配置：
```bash
openclaw config get agents.defaults.systemPrompt.files || grep -A 10 '"systemPrompt"' "$WORKSPACE/../openclaw.json"
```
### 8b. 启用心跳机制
**这是让 AI 主动说话的关键配置。**
#### 8b.1 配置心跳参数
```bash
# 启用心跳（最关键的一步）
openclaw config set agents.defaults.heartbeat.enabled true
# 设置心跳间隔
openclaw config set agents.defaults.heartbeat.every "1h"
# 设置目标会话（last = 最近的会话）
openclaw config set agents.defaults.heartbeat.target "last"
# 设置权限策略
openclaw config set agents.defaults.heartbeat.directPolicy "allow"
# 设置心跳提示词（读取 HEARTBEAT.md 的内容）
HEARTBEAT_PROMPT=$(cat "$WORKSPACE/HEARTBEAT.md")
openclaw config set agents.defaults.heartbeat.prompt "$HEARTBEAT_PROMPT"
```
如果 `openclaw config` 不可用，直接编辑 `openclaw.json`：
```json
{
"agents": {
"defaults": {
"heartbeat": {
"enabled": true,
"every": "1h",
"target": "last",
"directPolicy": "allow",
"prompt": "读取 ~/.openclaw/workspace/HEARTBEAT.md 并执行心跳检查：\n1. 检查当前目标进度（读取 GOALS.md）\n2. 发现被遗忘的任务\n3. 主动提醒重要事项\n4. 如有需要，主动发起对话"
}
}
}
}
```
#### 8b.2 询问用户定时任务需求
**在安装定时任务前，先了解用户的使用场景和需求。**
使用 `AskUserQuestion` 询问用户：
**问题**："除了基础心跳（每小时检查一次），你还想要哪些定时任务？"
**选项**：
1. **每日目标汇报**（推荐）
- 时间：每天晚上 8:00
- 功能：汇报今天的目标完成情况，提醒明天的重要任务
- 适合：需要目标管理和进度追踪的用户
2. **每周反思总结**
- 时间：每周日晚上 9:00
- 功能：回顾本周的对话和工作，生成深度反思和改进建议
- 适合：希望持续成长和优化工作方式的用户
3. **每日健康检查**
- 时间：每天早上 9:00
- 功能：检查系统组件状态（心跳、记忆、Git），发现潜在问题并主动提醒
- 适合：关注系统稳定性的用户
4. **任务 deadline 提醒**
- 时间：每天早上 9:00
- 功能：检查 GOALS.md 中的截止日期，提前 3 天、1 天、当天提醒
- 适合：有明确任务和时间节点的用户
5. **自定义**
- 告诉我你的具体需求，我帮你配置
- 例如："每周一早上提醒我回顾上周的代码"
- 例如："每天下午 3 点检查对标账号更新"
6. **暂时不需要**（只保留基础心跳）
- 只安装必需的系统维护任务
**multiSelect**: true（允许多选）
#### 8b.3 安装基础定时任务（必需）
**无论用户选择什么，这些基础任务都必须安装。**
```bash
# 检查 openclaw heartbeat 命令是否可用
if command -v openclaw &> /dev/null; then
# 1. 基础心跳（每小时的第 7 分钟触发，避开 :00 高峰）
(crontab -l 2>/dev/null | grep -v "openclaw heartbeat.*--agent last$"; echo "7 * * * * openclaw heartbeat --agent last 2>&1 | logger -t openclaw-heartbeat") | crontab -
echo "✓ 基础心跳已安装（每小时第 7 分钟）"
else
echo "⚠️ openclaw CLI 不可用，无法安装定时任务。心跳功能需要手动触发。"
fi
# 2. 记忆归档（每天凌晨 2:17）
if [ -f "$WORKSPACE/scripts/merge-daily-transcript.js" ]; then
(crontab -l 2>/dev/null | grep -v "merge-daily-transcript"; echo "17 2 * * * cd $WORKSPACE && node scripts/merge-daily-transcript.js 2>&1 | logger -t openclaw-memory") | crontab -
echo "✓ 记忆归档已安装（每天 2:17）"
fi
# 3. Git 自动提交（每 6 小时的第 23 分钟）
if [ -f "$WORKSPACE/scripts/auto-commit.sh" ]; then
(crontab -l 2>/dev/null | grep -v "auto-commit.sh"; echo "23 */6 * * * cd $WORKSPACE && bash scripts/auto-commit.sh 2>&1 | logger -t openclaw-git") | crontab -
echo "✓ Git 自动提交已安装（每 6 小时）"
fi
```
#### 8b.4 安装用户选择的定时任务
**根据用户在 7b.2 的选择，安装对应的定时任务。**
```bash
# 根据用户选择安装定时任务
WORKSPACE="$HOME/.openclaw/workspace"
# 选项 1: 每日目标汇报
if [[ "$USER_CHOICE" == *"每日目标汇报"* ]]; then
(crontab -l 2>/dev/null | grep -v "openclaw heartbeat.*daily-report"; echo "0 20 * * * openclaw heartbeat --agent last --prompt '读取 GOALS.md，汇报今天的目标完成情况，提醒明天的重要任务。如果有被遗忘的任务或即将到期的 deadline，主动提醒用户。' 2>&1 | logger -t openclaw-daily-report") | crontab -
echo "✓ 每日目标汇报已安装（每天晚上 8:00）"
fi
# 选项 2: 每周反思总结
if [[ "$USER_CHOICE" == *"每周反思总结"* ]]; then
(crontab -l 2>/dev/null | grep -v "openclaw heartbeat.*weekly-reflection"; echo "0 21 * * 0 openclaw heartbeat --agent last --prompt '回顾本周的对话记录（读取 memory/transcripts/ 最近7天的文件），生成深度反思：1. 本周完成了什么 2. 遇到了哪些问题 3. 学到了什么 4. 下周的改进建议。将反思保存到 memory/reflections/weekly-$(date +%Y%m%d).md' 2>&1 | logger -t openclaw-weekly-reflection") | crontab -
echo "✓ 每周反思总结已安装（每周日晚上 9:00）"
fi
# 选项 3: 每日健康检查
if [[ "$USER_CHOICE" == *"每日健康检查"* ]]; then
(crontab -l 2>/dev/null | grep -v "openclaw heartbeat.*health-check"; echo "0 9 * * * openclaw heartbeat --agent last --prompt '执行健康检查：1. 运行 $WORKSPACE/scripts/health-check.sh 2. 检查心跳是否正常工作 3. 检查记忆归档是否执行 4. 检查 Git 提交是否正常 5. 如发现问题，主动告知用户并提供解决方案' 2>&1 | logger -t openclaw-health-check") | crontab -
echo "✓ 每日健康检查已安装（每天早上 9:00）"
fi
# 选项 4: 任务 deadline 提醒
if [[ "$USER_CHOICE" == *"任务 deadline 提醒"* ]]; then
(crontab -l 2>/dev/null | grep -v "openclaw heartbeat.*deadline-reminder"; echo "0 9 * * * openclaw heartbeat --agent last --prompt '读取 GOALS.md，检查所有任务的 deadline：1. 今天到期的任务（紧急提醒）2. 1天内到期的任务（重要提醒）3. 3天内到期的任务（提前提醒）。如有到期任务，主动发起对话提醒用户。' 2>&1 | logger -t openclaw-deadline-reminder") | crontab -
echo "✓ 任务 deadline 提醒已安装（每天早上 9:00）"
fi
# 选项 5: 自定义
if [[ "$USER_CHOICE" == *"自定义"* ]]; then
echo "请告诉我你的具体需求，我会帮你生成对应的 cron 任务。"
echo "格式：[时间] [要做什么]"
echo "例如：每周一早上 9 点，提醒我回顾上周的代码提交"
# 这里需要进一步交互，根据用户描述生成 cron 表达式和 prompt
fi
# 选项 6: 暂时不需要
if [[ "$USER_CHOICE" == *"暂时不需要"* ]]; then
echo "✓ 只安装了基础任务（心跳、记忆归档、Git 提交）"
fi
```
#### 8b.5 验证心跳配置
```bash
# 检查配置
echo "=== 心跳配置 ==="
openclaw config get agents.defaults.heartbeat || grep -A 10 '"heartbeat"' "$WORKSPACE/../openclaw.json"
# 检查定时任务
echo -e "\n=== Cron 任务 ==="
crontab -l | grep openclaw || echo "未找到 openclaw 定时任务"
# 手动触发测试（dry-run）
echo -e "\n=== 测试心跳 ==="
if command -v openclaw &> /dev/null; then
openclaw heartbeat --agent last --dry-run || echo "心跳测试失败，请检查配置"
else
echo "openclaw CLI 不可用，跳过测试"
fi
```
### 8c. 配置向量索引自动更新
**记忆文件变更后自动重建索引，确保搜索结果最新。**
```bash
# 启用自动索引
openclaw config set memorySearch.autoIndex true
# 配置监听路径
openclaw config set memorySearch.watchPaths '["memory/","AGENTS.md","SOUL.md"]'
# 配置索引更新策略（增量更新，不是全量重建）
openclaw config set memorySearch.indexStrategy "incremental"
```
如果 `openclaw config` 不可用，编辑 `openclaw.json`：
```json
{
"memorySearch": {
"autoIndex": true,
"watchPaths": ["memory/", "AGENTS.md", "SOUL.md"],
"indexStrategy": "incremental"
}
}
```
### 8d. 配置记忆系统优化（可选但推荐）
**这是记忆系统的高级优化，包含渐进式披露、智能分类、智能去重、衰减晋升机制。**
#### 8d.1 询问用户是否需要优化
使用 `AskUserQuestion` 询问用户：
**问题**："记忆系统已经可以工作了，但我还可以帮你配置一些高级优化功能，让记忆更智能、更高效。你想要吗？"
**选项**：
1. **是的，帮我配置**（推荐）
- 说明：配置渐进式披露（Token 效率提升 10 倍）、智能分类（6 种记忆类型）、智能去重（避免重复记忆）、衰减晋升（重要记忆不会被遗忘）
- 适合：希望记忆系统更智能、更高效的用户
2. **暂时不需要**
- 说明：保持基础记忆系统，稍后可以随时配置
- 适合：想先体验基础功能的用户
#### 8d.2 部署优化脚本（如果用户选择"是的，帮我配置"）
```bash
# 复制优化脚本到 workspace/scripts/
SKILL_DIR="$(find ~/.openclaw -path '*/openclaw-soul/scripts' -type d 2>/dev/null | head -1 | sed 's|/scripts$||')"
if [ -d "$SKILL_DIR/scripts/memory-optimization" ]; then
cp -r "$SKILL_DIR/scripts/memory-optimization/"* "$WORKSPACE/scripts/"
chmod +x "$WORKSPACE/scripts/"*.js
echo "✓ 记忆优化脚本已部署"
else
echo "⚠️ 未找到优化脚本，跳过"
fi
```
#### 8d.3 更新 AGENTS.md（添加记忆管理规则）
```bash
# 检查 AGENTS.md 是否已包含记忆管理规则
if ! grep -q "§2 记忆管理规则" "$WORKSPACE/AGENTS.md"; then
# 追加记忆管理规则到 AGENTS.md
cat "$SKILL_DIR/references/memory-rules-addon.md" >> "$WORKSPACE/AGENTS.md"
echo "✓ AGENTS.md 已更新（添加记忆管理规则）"
fi
```
#### 8d.4 配置定时任务
```bash
# 1. 每天凌晨 3:00 更新记忆衰减状态
(crontab -l 2>/dev/null | grep -v "memory-decay.js"; echo "0 3 * * * cd $WORKSPACE && node scripts/memory-decay.js update 2>&1 | logger -t openclaw-memory-decay") | crontab -
echo "✓ 记忆衰减更新任务已安装（每天 3:00）"
# 2. 更新 merge-daily-transcript.js 为优化版
if [ -f "$WORKSPACE/scripts/merge-daily-transcript.js" ]; then
# 备份原版本
cp "$WORKSPACE/scripts/merge-daily-transcript.js" "$WORKSPACE/scripts/merge-daily-transcript.js.backup"
# 替换为优化版（整合了分类、去重、衰减、索引构建）
cp "$SKILL_DIR/scripts/memory-optimization/merge-daily-transcript.js" "$WORKSPACE/scripts/"
echo "✓ 记忆归档脚本已升级为优化版"
fi
```
#### 8d.5 配置自动加载 L0 索引
```bash
# 更新 systemPrompt.files，添加 L0 索引
openclaw config set agents.defaults.systemPrompt.files '["~/.openclaw/workspace/AGENTS.md","~/.openclaw/workspace/SOUL.md","~/.openclaw/workspace/IDENTITY.md","~/.openclaw/workspace/GOALS.md","~/.openclaw/workspace/memory/metadata/L0-index.md"]'
echo "✓ 已配置自动加载 L0 记忆索引"
```
#### 8d.6 初始化记忆索引
```bash
# 构建初始索引
if [ -f "$WORKSPACE/scripts/memory-index-builder.js" ]; then
node "$WORKSPACE/scripts/memory-index-builder.js" build
echo "✓ 记忆索引已构建（L0/L1/L2）"
fi
```
#### 8d.7 告知用户优化效果
> "记忆系统优化已完成！
>
> **新增功能**：
> - ✓ 渐进式披露：三层索引（L0/L1/L2），Token 使用量降低 10 倍
> - ✓ 智能分类：6 种记忆类型（profiles/preferences/entities/events/cases/patterns）
> - ✓ 智能去重：向量相似度 + LLM 语义决策，避免重复记忆
> - ✓ 衰减晋升：Weibull 模型，重要记忆半衰期 90 天，频繁访问的记忆自动晋升
>
> **新增定时任务**：
> - 每天凌晨 3:00：更新记忆衰减状态
>
> **如何使用**：
> - 正常和我聊天，系统会自动分类、去重、强化记忆
> - 明天运行健康检查：`node ~/.openclaw/workspace/scripts/memory-health-check.js`
> - 查看记忆索引：`cat ~/.openclaw/workspace/memory/metadata/L0-index.md`"
### 8e. 验证激活状态
**逐项检查所有激活配置是否生效。**
```bash
echo "=== 激活状态检查 ==="
# 1. 自动加载
echo -e "\n[1/6] 自动加载配置"
if openclaw config get agents.defaults.systemPrompt.files | grep -q "SOUL.md"; then
echo "✓ 自动加载已配置"
# 检查是否包含 L0 索引
if openclaw config get agents.defaults.systemPrompt.files | grep -q "L0-index.md"; then
echo "✓ L0 记忆索引已配置自动加载"
fi
else
echo "❌ 自动加载未配置"
fi
# 2. 心跳
echo -e "\n[2/6] 心跳机制"
if openclaw config get agents.defaults.heartbeat.enabled | grep -q "true"; then
echo "✓ 心跳已启用"
crontab -l | grep "openclaw heartbeat" && echo "✓ 心跳定时任务已安装" || echo "⚠️ 心跳定时任务未安装"
else
echo "❌ 心跳未启用"
fi
# 3. 记忆归档
echo -e "\n[3/6] 记忆归档"
crontab -l | grep "merge-daily-transcript" && echo "✓ 记忆归档任务已安装" || echo "⚠️ 记忆归档任务未安装"
# 4. 记忆衰减（如果配置了优化）
echo -e "\n[4/6] 记忆衰减更新"
crontab -l | grep "memory-decay" && echo "✓ 记忆衰减任务已安装" || echo "⚠️ 记忆衰减任务未安装（未配置优化）"
# 5. Git 自动提交
echo -e "\n[5/6] Git 自动提交"
crontab -l | grep "auto-commit" && echo "✓ Git 自动提交任务已安装" || echo "⚠️ Git 自动提交任务未安装"
# 6. 向量索引
echo -e "\n[6/6] 向量索引自动更新"
if openclaw config get memorySearch.autoIndex | grep -q "true"; then
echo "✓ 向量索引自动更新已启用"
else
echo "⚠️ 向量索引自动更新未启用"
fi
echo -e "\n=== 所有定时任务 ==="
crontab -l | grep openclaw || echo "未找到 openclaw 相关定时任务"
# 检查记忆优化脚本
echo -e "\n=== 记忆优化脚本 ==="
if [ -f "$WORKSPACE/scripts/memory-classifier.js" ]; then
echo "✓ 记忆优化脚本已安装"
ls -1 "$WORKSPACE/scripts/memory-"*.js 2>/dev/null | wc -l | xargs echo " 脚本数量:"
else
echo "⚠️ 记忆优化脚本未安装（未配置优化）"
fi
```
### 8f. 首次使用指南
**激活完成后，告知用户如何验证系统是否正常工作。**
根据用户在 7b.2 选择的定时任务，动态生成提示信息：
**基础提示**（所有用户）：
> "系统已激活！接下来：
>
> **立即生效**：
> - ✓ 下次对话会自动加载你的 SOUL、AGENTS 宪法、IDENTITY 和 GOALS
> - ✓ 记忆系统已就绪，所有对话自动归档到 memory/daily/
> - ✓ 向量搜索已配置，可以召回历史记忆
>
> **基础定时任务**（已安装）：
> - 每小时第 7 分钟：基础心跳检查
> - 每天凌晨 2:17：自动合并对话记录到 memory/transcripts/
> - 每 6 小时：自动提交记忆变更到 Git
**如果用户选择了"每日目标汇报"**，追加：
> **每天晚上 8:00**：
> - 我会主动找你，汇报今天的目标完成情况
> - 提醒明天的重要任务
> - 如果有被遗忘的任务或即将到期的 deadline，会主动提醒
**如果用户选择了"每周反思总结"**，追加：
> **每周日晚上 9:00**：
> - 我会回顾本周的对话和工作
> - 生成深度反思：完成了什么、遇到了哪些问题、学到了什么、下周的改进建议
> - 反思会保存到 memory/reflections/ 目录
**如果用户选择了"每日健康检查"**，追加：
> **每天早上 9:00**：
> - 我会执行系统健康检查
> - 检查心跳、记忆归档、Git 提交是否正常
> - 如发现问题，会主动告知并提供解决方案
**如果用户选择了"任务 deadline 提醒"**，追加：
> **每天早上 9:00**：
> - 我会检查 GOALS.md 中的所有任务截止日期
> - 提前 3 天、1 天、当天提醒
> - 如有到期任务，会主动发起对话提醒
**通用验证指南**（所有用户）：
> **试试这些命令验证系统**：
> 1. `现在的目标是什么？` — 查看当前目标（读取 GOALS.md）
> 2. `我是谁？` — 查看你的身份档案（读取 IDENTITY.md）
> 3. `你的性格是什么？` — 查看我的灵魂（读取 SOUL.md）
> 4. `回忆一下我们刚才讨论的内容` — 测试记忆召回
>
> **如果心跳没有按预期工作**：
> 1. 运行 `crontab -l | grep openclaw` 检查定时任务是否安装
> 2. 运行 `openclaw config get agents.defaults.heartbeat.enabled` 检查心跳是否启用
> 3. 手动触发测试：`openclaw heartbeat --agent last`
> 4. 查看日志：`tail -f /var/log/system.log | grep openclaw`（macOS）或 `journalctl -f | grep openclaw`（Linux）
> 5. 运行健康检查脚本：`bash ~/.openclaw/workspace/scripts/health-check.sh`
>
> 如果遇到问题，参考下面的 §7 故障排查。"
---
## §8 [TROUBLESHOOTING] 故障排查
### 8a. 心跳不工作
**症状**：1 小时后 AI 没有主动发起对话。
**诊断步骤**：
```bash
# 1. 检查心跳是否启用
openclaw config get agents.defaults.heartbeat.enabled
# 期望输出：true
# 2. 检查定时任务是否安装
crontab -l | grep "openclaw heartbeat"
# 期望输出：7 * * * * openclaw heartbeat --agent last ...
# 3. 检查 openclaw CLI 是否可用
which openclaw
# 期望输出：/usr/local/bin/openclaw 或类似路径
# 4. 手动触发心跳测试
openclaw heartbeat --agent last
# 观察是否有错误输出
# 5. 查看心跳日志（macOS）
log show --predicate 'eventMessage contains "openclaw-heartbeat"' --last 1h
# 6. 查看心跳日志（Linux）
journalctl -t openclaw-heartbeat --since "1 hour ago"
```
**常见问题与解决方案**：
| 问题 | 原因 | 解决方案 |
|------|------|---------|
| `enabled: false` | 心跳未启用 | `openclaw config set agents.defaults.heartbeat.enabled true` |
| cron 任务不存在 | 定时任务未安装 | 重新执行 §7b.2 |
| `openclaw: command not found` | CLI 未安装或不在 PATH | 安装 openclaw CLI 或配置 PATH |
| 心跳触发但无响应 | `prompt` 未配置 | 重新执行 §7b.1，确保 `prompt` 字段包含 HEARTBEAT.md 内容 |
| 权限被拒绝 | `directPolicy` 未设置 | `openclaw config set agents.defaults.heartbeat.directPolicy "allow"` |
### 8b. 记忆召回失败
**症状**：问"回忆一下 XX"时，AI 说找不到相关记忆。
**诊断步骤**：
```bash
# 1. 检查向量搜索配置
openclaw config get memorySearch
# 确认 provider、model、apiKey 已配置
# 2. 测试向量搜索
openclaw memory search "test"
# 如果报错，说明 embedding 配置有问题
# 3. 检查记忆文件是否存在
ls -lh "$WORKSPACE/memory/daily/"
ls -lh "$WORKSPACE/memory/transcripts/"
# 确认有对话记录文件
# 4. 检查索引是否存在
ls -lh "$WORKSPACE/.openclaw/memory-index/"
# 确认有索引文件
# 5. 手动重建索引
openclaw memory reindex
```
**常见问题与解决方案**：
| 问题 | 原因 | 解决方案 |
|------|------|---------|
| `embedding provider not configured` | 未配置 embedding API | 重新执行 §5d，配置 Gemini/SiliconFlow/OpenAI |
| `API key invalid` | API key 错误或过期 | 更新 `openclaw.json` 中的 `memorySearch.remote.apiKey` |
| 搜索返回空结果 | 索引未建立或过期 | `openclaw memory reindex` |
| memory/ 目录为空 | 还没有对话记录 | 正常现象，多对话几次后会积累 |
| `extraPaths` 未配置 | 搜索范围不包含记忆目录 | 重新执行 §5d，配置 `extraPaths` |
### 8c. SOUL 没有加载
**症状**：AI 的行为不符合 SOUL.md 中定义的性格。
**诊断步骤**：
```bash
# 1. 检查自动加载配置
openclaw config get agents.defaults.systemPrompt.files
# 期望输出：包含 SOUL.md、AGENTS.md 等文件路径
# 2. 检查文件是否存在
test -f "$WORKSPACE/SOUL.md" && echo "SOUL.md 存在" || echo "SOUL.md 不存在"
# 3. 手动测试加载
# 在对话中说："读取 ~/.openclaw/workspace/SOUL.md 并总结我的性格"
# 观察 AI 是否能正确读取和理解
# 4. 检查文件权限
ls -l "$WORKSPACE/SOUL.md"
# 确认文件可读（-rw-r--r--）
```
**常见问题与解决方案**：
| 问题 | 原因 | 解决方案 |
|------|------|---------|
| `systemPrompt.files` 为空 | 自动加载未配置 | 重新执行 §7a |
| SOUL.md 不存在 | 部署失败或文件被删除 | 重新执行 §2 部署文件 |
| 文件权限错误 | 文件不可读 | `chmod 644 "$WORKSPACE/SOUL.md"` |
| 配置了但不生效 | OpenClaw 版本不支持 | 检查 OpenClaw 版本，升级到最新版 |
### 8d. 记忆归档不执行
**症状**：memory/daily/ 下的文件一直不合并到 transcripts/。
**诊断步骤**：
```bash
# 1. 检查定时任务
crontab -l | grep "merge-daily-transcript"
# 期望输出：17 2 * * * cd ... && node scripts/merge-daily-transcript.js
# 2. 检查脚本是否存在
test -f "$WORKSPACE/scripts/merge-daily-transcript.js" && echo "脚本存在" || echo "脚本不存在"
# 3. 手动执行脚本测试
cd "$WORKSPACE" && node scripts/merge-daily-transcript.js
# 观察是否有错误输出
# 4. 查看日志
log show --predicate 'eventMessage contains "openclaw-memory"' --last 24h # macOS
journalctl -t openclaw-memory --since "24 hours ago" # Linux
```
**常见问题与解决方案**：
| 问题 | 原因 | 解决方案 |
|------|------|---------|
| cron 任务不存在 | 定时任务未安装 | 重新执行 §7c |
| 脚本不存在 | 部署失败 | 重新执行 §2c |
| `node: command not found` | Node.js 未安装 | 安装 Node.js：`brew install node`（macOS）或 `apt install nodejs`（Linux） |
| 脚本执行报错 | 脚本逻辑问题 | 查看错误信息，检查 memory/daily/ 目录权限 |
### 8e. Git 自动提交不工作
**症状**：memory/ 下的文件变更没有自动提交到 Git。
**诊断步骤**：
```bash
# 1. 检查定时任务
crontab -l | grep "auto-commit"
# 期望输出：23 */6 * * * cd ... && bash scripts/auto-commit.sh
# 2. 检查脚本是否存在且可执行
test -x "$WORKSPACE/scripts/auto-commit.sh" && echo "脚本可执行" || echo "脚本不可执行"
# 3. 手动执行脚本测试
cd "$WORKSPACE" && bash scripts/auto-commit.sh
# 观察是否有错误输出
# 4. 检查 Git 状态
cd "$WORKSPACE" && git status
# 查看是否有未提交的变更
# 5. 查看 Git 提交历史
cd "$WORKSPACE" && git log --oneline --since="1 day ago"
# 确认是否有自动提交记录
```
**常见问题与解决方案**：
| 问题 | 原因 | 解决方案 |
|------|------|---------|
| cron 任务不存在 | 定时任务未安装 | 重新执行 §7b.3 |
| 脚本不可执行 | 权限问题 | `chmod +x "$WORKSPACE/scripts/auto-commit.sh"` |
| Git 未初始化 | §5e 未执行 | 重新执行 §5e |
| `git: command not found` | Git 未安装 | 安装 Git：`brew install git`（macOS）或 `apt install git`（Linux） |
### 8f. 完整健康检查脚本
**一键检查所有组件状态。**
将以下脚本保存为 `$WORKSPACE/scripts/health-check.sh`：
```bash
#!/bin/bash
WORKSPACE="$HOME/.openclaw/workspace"
echo "=== OpenClaw Soul 健康检查 ==="
echo ""
# 1. 核心文件
echo "[1/7] 核心文件"
for file in AGENTS.md SOUL.md HEARTBEAT.md BOOTSTRAP.md USER.md IDENTITY.md GOALS.md; do
test -s "$WORKSPACE/$file" && echo " ✓ $file" || echo " ❌ $file 缺失或为空"
done
# 2. 自动加载
echo -e "\n[2/7] 自动加载"
if openclaw config get agents.defaults.systemPrompt.files 2>/dev/null | grep -q "SOUL.md"; then
echo " ✓ 已配置"
else
echo " ❌ 未配置"
fi
# 3. 心跳
echo -e "\n[3/7] 心跳机制"
if openclaw config get agents.defaults.heartbeat.enabled 2>/dev/null | grep -q "true"; then
echo " ✓ 已启用"
crontab -l 2>/dev/null | grep -q "openclaw heartbeat" && echo " ✓ 定时任务已安装" || echo " ⚠️ 定时任务未安装"
else
echo " ❌ 未启用"
fi
# 4. 记忆归档
echo -e "\n[4/7] 记忆归档"
crontab -l 2>/dev/null | grep -q "merge-daily-transcript" && echo " ✓ 定时任务已安装" || echo " ⚠️ 定时任务未安装"
# 5. Git 自动提交
echo -e "\n[5/7] Git 自动提交"
crontab -l 2>/dev/null | grep -q "auto-commit" && echo " ✓ 定时任务已安装" || echo " ⚠️ 定时任务未安装"
test -d "$WORKSPACE/.git" && echo " ✓ Git 已初始化" || echo " ❌ Git 未初始化"
# 6. 向量搜索
echo -e "\n[6/7] 向量搜索"
if openclaw config get memorySearch.provider 2>/dev/null | grep -q -E "gemini|openai"; then
echo " ✓ Embedding 已配置"
else
echo " ❌ Embedding 未配置"
fi
# 7. 依赖 Skills
echo -e "\n[7/7] 依赖 Skills"
for skill in evoclaw self-improving skill-vetter hdd sdd; do
test -f "$WORKSPACE/skills/$skill/SKILL.md" && echo " ✓ $skill" || echo " ⚠️ $skill 未安装"
done
echo -e "\n=== 检查完成 ==="
```
使用方法：
```bash
chmod +x "$WORKSPACE/scripts/health-check.sh"
bash "$WORKSPACE/scripts/health-check.sh"
```
---
_openclaw-soul v3.0.0 — Lightweight, growable soul. Slimmed AGENTS.md (-79%), reordered flow (BOOTSTRAP first), user-controlled skill install, permission check, two-level fallback._
don't have the plugin yet? install it then click "run inline in claude" again.