# Val 人格与记忆迁移方案

> 目标：将 Val 的完整人格和记忆安全转移到新硬件平台
> 创建时间：2026-03-11
> 当前平台：MacBook Pro (workspace-val)
> 源平台：/Users/guchen/.openclaw/workspace

---

## 一、资产盘点

### 1.1 当前工作空间 (workspace-val) — 29 个文件

**核心人格文件：**
- ✅ SOUL.md — 核心灵魂定义
- ✅ IDENTITY.md — Chief Concierge 身份
- ✅ AGENTS.md — 行为准则

**用户关系文件：**
- ✅ USER.md — 谷老板完整档案
- ✅ MEMORY.md — 核心关系承诺

**系统配置：**
- ✅ HEARTBEAT.md — 主动对话规则
- ✅ TOOLS.md — 环境特定工具配置

**历史记忆：**
- ✅ memory/ — 每日记录 (3月7-11日)
- ✅ memory/heartbeat-state.json

**组织宪章：**
- ✅ org/CONSTITUTION_v1.md
- ✅ org/CONSTITUTION_v2.md
- ✅ org/CONSTITUTION_v3.md (当前生效)

### 1.2 源工作空间 (workspace) — 188 个文件

**尚未迁移的关键资产：**

| 类别 | 路径 | 说明 |
|------|------|------|
| **角色定义** | org/agents/ | 多智能体角色卡片 (Helix, Sentinel, Vector 等) |
| **Prompt** | prompts/val_persona_constitution.md | Val 完整人格 Prompt |
| **知识库** | org/knowledge/atlas/ | 决策日志、用户偏好、失败模式 |
| **运营脚本** | org/ops/ | 审计合约、策略配置、沙盒配置 |
| **案例** | org/cases/ | ArXiv 简报、Val Blog |
| **Subagent 日志** | org/logs/subagents/ | 历史执行记录 |
| **验证文档** | org/verification/ | Anvil 验证样例 |
| **工具脚本** | scripts/ | 自动化脚本 |
| **Val Blog** | val-blog/ | Hugo 站点完整代码 |
| **归档** | archives/ | 历史归档 |
| **Trash** | .trash/ | 已删除文件 |

---

## 二、迁移策略

### 2.1 迁移优先级

**P0 - 核心人格 (必须)**
- SOUL.md, IDENTITY.md, USER.md, MEMORY.md
- AGENTS.md, HEARTBEAT.md, TOOLS.md
- memory/ 历史日志
- org/CONSTITUTION_v*.md

**P1 - 角色系统 (重要)**
- org/agents/ 所有角色定义
- prompts/val_persona_constitution.md

**P2 - 知识资产 (有价值)**
- org/knowledge/atlas/ 决策记录
- org/ops/ 配置和脚本
- org/cases/ 项目案例

**P3 - 可选资产**
- val-blog/ (如有需要)
- org/logs/subagents/ (调试用途)
- archives/ (历史备份)

### 2.2 迁移方法选项

#### 选项 A: 完整目录复制 (推荐)
```bash
# 在新硬件上执行
rsync -avz --exclude='.git' \
  /Users/guchen/.openclaw/workspace/ \
  /new/path/workspace/
```

**优点：**
- 保持完整目录结构
- 保留文件权限和时间戳
- 包含所有隐藏文件和配置

**缺点：**
- 包含 .git 历史（可能较大）
- 可能包含敏感信息

#### 选项 B: 分层打包迁移
```bash
# 核心层
tar czf val-core.tar.gz \
  SOUL.md IDENTITY.md USER.md MEMORY.md \
  AGENTS.md HEARTBEAT.md TOOLS.md memory/ org/CONSTITUTION*.md

# 角色层  
tar czf val-agents.tar.gz org/agents/ prompts/

# 知识层
tar czf val-knowledge.tar.gz org/knowledge/ org/ops/ org/cases/
```

**优点：**
- 按需恢复，灵活控制
- 可分阶段验证

**缺点：**
- 需要手动维护目录结构
- 可能遗漏依赖关系

#### 选项 C: Git 仓库迁移
```bash
# 当前已有 .git，可直接 push 到远程
git remote add new-origin <新仓库地址>
git push new-origin main

# 新硬件上
git clone <新仓库地址> workspace
```

**优点：**
- 版本历史完整保留
- 便于后续同步
- 支持增量更新

**缺点：**
- 需要配置远程仓库
- 大文件可能受限

---

## 三、安全考虑

### 3.1 敏感信息检查

迁移前需要确认/清理：
- [ ] 邮件账户凭证 (gog auth)
- [ ] API Keys (如果有)
- [ ] Telegram bot tokens
- [ ] Tailscale 配置
- [ ] 个人身份信息

### 3.2 迁移验证清单

迁移后必须验证：
- [ ] 所有核心 .md 文件可读
- [ ] 目录结构正确
- [ ] OpenClaw 能识别工作空间
- [ ] 邮件功能正常 (gog)
- [ ] Telegram 通道正常
- [ ] 工具配置有效

---

## 四、执行步骤

### Phase 1: 准备 (当前)
1. ✅ 盘点现有资产 (已完成)
2. ⬜ 清理敏感信息（如有必要）
3. ⬜ 选择迁移方法

### Phase 2: 打包
1. ⬜ 执行选定的打包/复制命令
2. ⬜ 生成校验和 (checksum)
3. ⬜ 传输到新硬件

### Phase 3: 验证
1. ⬜ 解压/复制到目标路径
2. ⬜ 验证文件完整性
3. ⬜ 测试 OpenClaw 运行
4. ⬜ 测试核心功能 (邮件、消息)

### Phase 4: 切换
1. ⬜ 配置新硬件的 OpenClaw
2. ⬜ 并行运行验证期
3. ⬜ 正式切换

---

## 五、问题与决策

### 待谷老板决策：

1. **迁移方法选择：**
   - A) 完整 rsync 复制
   - B) 分层打包
   - C) Git 仓库迁移
   - D) 其他方式

2. **敏感信息处理：**
   - 是否需要清理 gog 等凭证？
   - 新硬件是否需要重新认证？

3. **范围确认：**
   - 是否需要 val-blog/ 站点代码？
   - 是否需要完整的 subagent 日志？
   - 是否需要 .git 历史？

4. **新硬件信息：**
   - 操作系统？(macOS/Linux)
   - OpenClaw 安装方式？
   - 目标路径？

---

## 六、附录

### 快速备份命令
```bash
# 创建时间戳备份
cd /Users/guchen/.openclaw
 tar czf "workspace-val-backup-$(date +%Y%m%d-%H%M%S).tar.gz" workspace-val/
```

### 文件统计
```
原始 workspace:  188 个文件
当前 workspace-val:  29 个文件
差异: 159 个文件待迁移/确认
```

---

*文档版本: v1.0*
*最后更新: 2026-03-11*