> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/zhi-nan/guides/move-to-new-pc.md).

# 将 OpenHuman 迁移到新电脑

**目标：** 在新机器上设置 OpenHuman，使其从旧机器停止的地方继续（相同的记忆、相同的人设、相同的设置），并以安全级别的细节处理凭据。

简而言之： **复制一个文件夹，重新登录。** 细微之处在于文件夹复制会带走什么、不会带走什么，本指南会把这些说明清楚，免得你感到意外。

***

## 前提条件

* 两台电脑都可用（或者旧电脑数据文件夹的备份）。
* 你的 OpenHuman 登录凭据。
* 一种在它们之间传输文件的方法（外部硬盘、安全文件传输等）。

## 内容存放在哪里

OpenHuman 持久保存的一切都在一个文件夹里：

| 平台            | 数据文件夹                       |
| ------------- | --------------------------- |
| macOS / Linux | `~/.openhuman/`             |
| Windows       | `%USERPROFILE%\.openhuman\` |

在其中，你关心需要迁移的内容：

| 什么                           | 位置（在数据文件夹内）                              | 会随文件夹复制一起带走吗？ |
| ---------------------------- | ---------------------------------------- | ------------- |
| **记忆树** （数据库）                | `.../memory_tree/chunks.db`              | ✅ 会           |
| **Obsidian 知识库** （可读记忆）      | `.../wiki/`                              | ✅ 会           |
| **人设与行为**                    | `SOUL.md`, `IDENTITY.md`, `HEARTBEAT.md` | ✅ 会           |
| **Config** （模型、提供商、路由、自主性）   | `config.toml`                            | ✅ 会           |
| **会话历史**                     | `sessions/`, `session_raw/`              | ✅ 会           |
| **审批历史**                     | `approval/approval.db`                   | ✅ 会           |
| **操作系统中存储的秘密** （会话令牌、某些本地密钥） | 你的操作系统钥匙串， **不** 在这个文件夹中                 | ❌ 不会（登录后重新建立） |
| **集成访问** （Gmail、Slack 等）     | 由后端中转，与您的账户绑定                            | ❌ 不会（登录后重新连接） |

{% hint style="info" %}
**为什么有些东西不会随之迁移，以及为什么这没关系。** OpenHuman 会刻意把秘密信息排除在松散文件之外。你的会话令牌和某些本地秘密保存在操作系统的安全存储中（钥匙串 / 凭据管理器 / Secret Service），而你的集成令牌则由后端按账户保存。因此，文件夹复制会带走你的 *数据和人设*; **在新机器上登录后会重新建立这些秘密和集成。** 你永远不需要在机器之间手动复制原始令牌。
{% endhint %}

***

## 步骤

### 1. 在旧机器上退出 OpenHuman

完全关闭应用，确保没有内容正在写入数据库。干净复制需要源端处于静默状态。

### 2. 复制数据文件夹

复制 **整个** 旧机器上的数据文件夹到新机器上的相同位置：

* macOS / Linux：复制 `~/.openhuman/` → `~/.openhuman/`
* Windows：复制 `%USERPROFILE%\.openhuman\` → `%USERPROFILE%\.openhuman\`

复制整个文件夹，而不是挑选其中部分。这样可以让记忆、人设、配置和历史保持一致。

数据文件夹包含配置和记忆， **不** 以及代理在其操作沙箱中创建或编辑的文件。还要复制你的 **projects/action 文件夹**，默认情况下 `~/OpenHuman/projects` （或者你指定的 action 目录所在位置）。否则这些项目文件就会留在旧电脑上。

{% hint style="warning" %}
把它复制到安全的地方。这个文件夹包含可读形式的个人记忆。请像搬运个人文件一样对待这次传输。
{% endhint %}

### 3. 在新机器上安装 OpenHuman

从 [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman)安装当前版本。如果数据文件夹已经放好，应用在启动时会找到它。（顺序并不绝对重要；先安装再复制也可以，只要复制时应用没有运行。）

### 4. 启动并登录

打开应用并使用 **同一账户**登录：

* 在新机器的操作系统钥匙串中重新建立你的会话令牌。
* 重新连接你的账户，使由后端中转的集成恢复。

### 5. 重新连接任何按账户范围的项目

* **集成** （Gmail、Slack 等）：确认它们在 **设置**下显示为已连接。如果有任何需要新的 OAuth 授权，请重新授权。每项只需快速点击一下。
* **自带密钥：** 如果你之前输入过自己的提供商 API 密钥、Composio 直连密钥或类似的 **局部** 秘密信息，请在新机器上重新输入。它们存储在操作系统钥匙串中，不会随文件夹一起迁移。

### 6. 重新检查模型/提供商配置

你的 `config.toml` 也会一起带过来，因此模型路由和提供商选择应该已经匹配。如果你使用了 [本地模型](/openhuman/zh/zhi-nan/guides/local-model.md)，记得 **Ollama/LM Studio 是独立的软件**。也在新机器上安装它，并让 OpenHuman 重新拉取模型权重（它们不在数据文件夹中）。

***

## 成功检查

迁移成功的标志：

* [ ] 这个 **记忆** 新机器上的标签页显示你现有的摘要。你的记忆已经带过来了。
* [ ] 助手以你配置的风格回复，并且你的显示名称/人设完好无损。
* [ ] 已连接的集成在 **设置** 下显示为已连接（把未连接的重新连接）。
* [ ] 你的自主级别和设置与你之前的一致（检查 **设置 → 代理 → 代理访问**).
* [ ] 如果你使用本地 AI：新机器上已安装 Ollama，且本地 AI 报告 `就绪` 在模型重新拉取后。

## 常见故障

| 症状            | 原因                             | 修复方法                                                                   |
| ------------- | ------------------------------ | ---------------------------------------------------------------------- |
| 新机器从零开始，没有记忆  | 数据文件夹不在正确位置，或者复制时应用正在运行        | 退出应用，把文件夹放到 `~/.openhuman/` （或者 `%USERPROFILE%\.openhuman\`），然后重新启动    |
| 已登录但集成已断开     | 集成访问属于账户/后端范围，不在文件夹中           | 在设置中重新连接每个集成（每个 OAuth 只需点一下）                                           |
| 新电脑上的本地模型无法工作 | Ollama/LM Studio 和权重不在新机器上     | 安装运行时并让模型重新拉取；参见 [本地模型指南](/openhuman/zh/zhi-nan/guides/local-model.md) |
| 助手失去了个性       | `SOUL.md` / `IDENTITY.md` 没有复制 | 复制 **整个** 数据文件夹，而不只是数据库                                                |
| 新机器登录卡住       | 与迁移无关的认证/处理程序问题                | 另见 [登录故障排查](/openhuman/zh/gai-lan/troubleshooting-sign-in.md)          |

## 恢复

* **在确认新机器正常前，保留旧机器上的文件夹。** 在所有成功检查通过之前，不要清空源端。
* 如果新机器根本无法启动，请把它当作全新安装问题： [从失败的安装中恢复](/openhuman/zh/zhi-nan/guides/recover-failed-installation.md)。你复制的文件夹可以安全地移到一边并恢复。

## 另请参阅

* [从失败的安装中恢复](/openhuman/zh/zhi-nan/guides/recover-failed-installation.md)：相同的数据文件夹，不同的问题。
* [保护敏感数据的隐私](/openhuman/zh/zhi-nan/guides/privacy-sensitive-data.md)：秘密信息为什么会以那样的方式存储。