核心用法
openclaw-soul 是 OpenClaw 生态的基石级部署技能，通过一键式 bash 脚本完成从空目录到完整自我进化 Agent 工作区的构建。执行后自动完成：
1. 九大核心文件部署：AGENTS.md（宪法）、SOUL.md（可进化灵魂）、BOOTSTRAP.md（引导对话）、HEARTBEAT.md（心跳协议）、USER.md/IDENTITY.md（用户与身份画像）、GOALS.md（目标管理）、双层记忆文件（working/long-term）
2. 七项依赖技能三级Fallback安装：EvoClaw（审批制进化治理）、Self-Improving Agent（自主学习）、HDD/SDD（假设/场景驱动开发方法论）、save-game/load-game（跨会话存档）、project-skill-pairing（项目结对）
3. 六层记忆基础设施：daily/entities/transcripts/projects/voice/experiences/significant/reflections/proposals/pipeline 目录 + 自动合并脚本 + Git 版本管理
4. 向量搜索强制配置：检测并引导配置 embedding provider（推荐 Gemini/硅基流动），启用混合搜索（MMR+时间衰减）
5. 引导对话自动触发：读取 BOOTSTRAP.md 执行三步认识流程（了解用户→定义性格→确认身份）
触发关键词：「灵魂框架」「部署灵魂」「BOOTSTRAP」「首次对话」「安装进化框架」「openclaw-soul」。
显著优点
- 可靠性优先设计：强制使用
cp而非 Write 工具部署大文件，避免截断风险；10 项验证清单确保部署完整性 - 三级降级策略：clawhub → 离线 fallback → 内联版本，保证功能完整性即使工具链缺失
- 治理内置：EvoClaw advisory 模式自动配置，核心身份/能力树/价值函数变更需用户审批，工作风格/用户理解可自动进化
- 记忆系统就绪：强制配置向量搜索，extraPaths 预置 transcripts/projects/AGENTS.md，支持 MMR 去重与时间衰减排序
- 版本化灵魂：soul-revisions 目录 + Git 管理，每次 SOUL.md 变更前自动快照，支持回滚
潜在缺点与局限性
- 依赖外部 embedding 服务：向量搜索强制要求 API key，完全离线场景需额外配置本地模型（未内置）
- Linux/macOS 优化：Windows 路径处理依赖 Git Bash/WSL，原生 cmd/PowerShell 兼容性未明确保证
- 首次配置门槛：需理解 AGENTS.md/SOUL.md/IDENTITY.md 的协作关系，纯新手可能需要阅读 BOOTSTRAP.md 引导
- 无自动更新机制：依赖 skill 安装后不会自动同步上游版本，需手动重新触发或配置 clawhub
适合人群
- AI 应用开发者：需要为 Claude/ChatGPT 类对话 Agent 构建持久化、可进化的长期运行环境
- 个人知识管理用户：希望 Agent 能跨会话记忆项目上下文、自动归档对话、形成用户画像
- AI 安全研究者：关注 Constitution AI、可解释性治理（EvoClaw 审批制）、自我改进边界控制的场景
- 开源 Agent 框架贡献者：研究 OpenClaw 架构、SOUL.md 规范、六层记忆模型的实现参考
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| **配置覆盖** | 重复执行会备份并覆盖已有文件 | 自动 `.backup.时间戳` 机制，但用户需手动合并历史版本 |
| **API key 泄露** | embedding 配置需写入 openclaw.json | `.gitignore` 自动排除 `.env*` 和 `*.secrets`，建议用环境变量注入 |
| **权限问题** | `chmod +x` 脚本需要执行权限 | 默认部署到用户目录（`~/.openclaw`），避免系统目录权限冲突 |
| **心跳频率** | 默认 1h 自动触发可能产生调用成本 | 可通过 `openclaw config set` 调整，或关闭 `directPolicy` |
| **版本兼容性** | v2.1.0 与旧版 OpenClaw 目录结构可能不兼容 | 严格检测 `~/.openclaw/workspace` 存在性，失败即停止 |