OpenHuman 备份与迁移指南 — 安全转移你的记忆系统

使用 OpenHuman 一段时间后，Memory Tree 会积累大量有价值的个人知识。换电脑或重装系统时，正确备份和恢复这些数据很重要。

需要备份哪些数据

备份 Memory Tree

找到 .openhuman 目录打包即可：

# macOS / Linux
tar -czf openhuman-backup.tar.gz ~/.openhuman

# Windows PowerShell
Compress-Archive -Path "$env:USERPROFILE.openhuman" -DestinationPath "openhuman-backup.zip"

迁移到新电脑

1. 在新电脑上安装 OpenHuman
2. 先将 OpenHuman 运行一次，让它在 .openhuman 生成默认配置
3. 关闭 OpenHuman
4. 将旧电脑的 .openhuman 目录完整覆盖到新电脑
5. 重新启动 OpenHuman

导出 Obsidian 笔记

如果你配置了 obsidian_vault_path，Memory Tree 中的数据会自动以 .md 文件落地。可以直接在 Obsidian 中打开查看。这意味着即使没有 OpenHuman，这些笔记也是可读的。

恢复配置

config.toml 包含 API Key。迁移到新电脑后：

• 如果从备份直接覆盖，config.toml 自动恢复
• 如果手动配置，记得重新输入 API Key
• 检查模型 provider 是否在新环境可用

多设备同步方案

OpenHuman 目前不提供官方云同步，但你可以：

• iCloud / 云盘：将 .openhuman 目录放在同步盘中（注意冲突风险）
• PostgreSQL 共享后端：在 config 中配置共享数据库
• Obsidian + 云盘：Memory Tree 导出的笔记可通过 Obsidian 云同步

定期备份建议

建议每周自动备份一次。可以写一个简单的 cron 任务或计划任务：

# macOS/Linux crontab（每周一凌晨备份）
0 3 * * 1 tar -czf ~/backups/openhuman-$(date +%Y%m%d).tar.gz ~/.openhuman/

相关阅读

• Memory Tree 配置指南
• config.toml 完全指南
• 安全与隐私分析