企业官网建设流程全解析

如何把 OpenHuman 迁移到新电脑：复制 .openhuman 数据文件夹并重新登录

【免费下载链接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.项目地址: https://gitcode.com/GitHub_Trending/op/openhuman

如果你的旧电脑上的 OpenHuman 已经积累了本地记忆（Memory Tree）、助手人格（persona）和模型/供应商配置，而你要换到新电脑，目标是让新机器"接着用"：同样的记忆、同样的人格、同样的设置，并且凭据在安全的粒度下处理。整个过程可以概括为一句话：复制一个文件夹，重新登录。这篇文章基于项目自带的迁移指南 Move OpenHuman to a new PC，把"文件夹拷贝会带什么、不会带什么"讲清楚，避免换机后出现意外。

准备条件

• 两台电脑都可以使用（或者你手头有旧电脑数据文件夹的备份）；
• 你的 OpenHuman 登录凭据，迁移完成后要用同一个账号登录新机器；
• 一种在两台机器之间移动文件的方式：外置硬盘、安全文件传输等。

数据都存放在哪里

OpenHuman 持久化的所有内容都在一个文件夹里：

文件夹内部，与迁移直接相关的内容如下（这是源文档给出的完整对照，决定了一次文件夹拷贝会带走什么、不会带走什么）：

OpenHuman 刻意不把密钥放进普通文件：session token 和部分本地密钥存放在操作系统的安全存储中，集成 token 由后端针对你的账号持有。因此文件夹拷贝带走的是数据和人格，而在新机器上登录会重建密钥和集成。你不需要在两台机器之间手工拷贝原始 token。

另有一个容易遗漏的点：数据文件夹包含 config 和 memory，但不包含agent 在其 action sandbox 里创建或编辑的文件。还需要拷贝你的项目/action 目录，默认是~/OpenHuman/projects（或者你另行指定的 action 目录），否则这些项目文件会留在旧电脑上。

第 1 步：在旧机器上退出 OpenHuman

彻底关闭应用，确保没有内容正在写入数据库。干净的拷贝需要一个"安静"的源。

第 2 步：拷贝数据文件夹（以及项目目录）

把整个数据文件夹从旧机器拷到新机器的相同位置：

• macOS / Linux：拷贝~/.openhuman/→~/.openhuman/
• Windows：拷贝%USERPROFILE%\.openhuman\→%USERPROFILE%\.openhuman\

拷贝整个文件夹，而不是挑选部分文件——这样才能保证记忆、人格、配置和历史彼此一致。同时按上一节所述拷贝~/OpenHuman/projects（或你的 action 目录）。

这个文件夹以可读形式包含你的个人记忆，传输时要像搬运个人文件一样谨慎，放在安全的地方。

第 3 步：在新机器上安装 OpenHuman

从官方网站 tinyhumans.ai/openhuman 安装当前构建版本。如果数据文件夹已经在位，应用启动时会自动找到它。安装和拷贝的顺序不严格：先装应用、后拷文件夹也可以，前提是拷贝期间应用没有在运行。

第 4 步：启动并用同一账号登录

打开应用，用同一个账号登录。登录会完成两件不在文件夹拷贝范围内的事：

• 在新机器的 OS 密钥库中重建你的 session token；
• 重新连接你的账号，让后端托管的集成恢复。

第 5 步：重连账号级集成和本地密钥

• 集成（Gmail、Slack 等）：在Settings里确认它们显示为已连接；如果某个需要重新 OAuth 授权，重新批准即可，每个只需一次点击。
• 自带密钥：如果你在旧机器上填过自己的供应商 API key、Composio direct key 之类的本地密钥，在新机器上重新输入。它们存储在 OS 密钥库中，不会随文件夹带过来。

第 6 步：复查模型/供应商配置（使用本地模型时）

config.toml已经随文件夹带过来，模型路由和供应商选择应该本来就一致。如果你之前使用了本地模型，注意Ollama / LM Studio 是独立的软件：在新机器上也要安装它，并让 OpenHuman 重新拉取模型权重——权重不在数据文件夹里。本地模型的完整配置与排错参见 Use OpenHuman with a local model。

验证迁移是否成功

按源文档的清单逐项核对：

• 新机器的Memory标签页显示你已有的 summaries——记忆带过来了；
• 助手以你配置的语气回复，显示名/人格完好；
• 已连接的集成在Settings中显示为 connected（没有的连接上的）；
• 自治级别和设置与旧机器一致（检查Settings → Agents → Agent access）；
• 如果你用本地 AI：Ollama 已安装在新机器上，模型重新拉取后 Local AI 报告ready。

迁移后出问题的对照排查

登录卡住时的进一步排查

若登录流程卡住，先按 Troubleshooting Sign-In 检查后端可达性（在桌面应用所在的网络环境执行）：

curl -I https://tinyhumans.ai/ curl -I https://api.tinyhumans.ai/health

如果网站能打开但 API 端点失败，桌面应用可能无法把 OAuth 回调换成 session。

Windows 上有一类与迁移直接相关的特殊问题：openhuman://URL scheme 是通过首次启动注册的；如果首次启动时注册静默失败，或安装被移动/拷贝过，浏览器就无法把 OAuth 回调交还给应用，登录会在 provider 步骤后停住。Tauri 外壳在启动时遇到这种情况会输出一行log::error!，去日志文件（默认%USERPROFILE%\.openhuman\logs\openhuman.*.log）里找：

[deep-link] openhuman:// scheme registration unhealthy — OAuth callbacks may never reach the app. register_all_error=…, hkcu_status=NotRegistered|MissingCommand|Stale { … }|ReadError(…)

文档给出的手动修复方式是：用运行 OpenHuman 的同一个用户打开 PowerShell（不需要管理员权限，HKCU 是 per-user 的），执行注册表修复脚本。注意这段脚本的副作用是向当前用户的 HKCU 注册表写入Software\Classes\openhuman相关项，且脚本第一行的$exe必须替换为你的实际安装路径：

$exe = 'C:\Path\To\OpenHuman.exe' # 替换为你的实际安装路径 New-Item -Path 'HKCU:\Software\Classes\openhuman' -Force | Out-Null Set-ItemProperty -Path 'HKCU:\Software\Classes\openhuman' -Name '(Default)' -Value 'URL:OpenHuman Protocol' New-ItemProperty -Path 'HKCU:\Software\Classes\openhuman' -Name 'URL Protocol' -Value '' -Force | Out-Null New-Item -Path 'HKCU:\Software\Classes\openhuman\shell\open\command' -Force | Out-Null Set-ItemProperty -Path 'HKCU:\Software\Classes\openhuman\shell\open\command' -Name '(Default)' -Value ('"' + $exe + '" "%1"')

执行后重启 OpenHuman 并重试登录。如果日志中register_all_error非None（例如杀软或受管控镜像阻止了对HKCU\Software\Classes的写入），需要先解决底层策略问题，手动脚本会遇到同样的阻拦。

限制与兜底

• 在新机器验证通过之前，保留旧机器的数据文件夹，不要提前擦除源。
• 如果新机器完全无法启动，按全新安装问题处理：参见 Recover from a failed installation。你拷贝过来的文件夹是安全的，可以移到一边再恢复。
• 密钥的存储位置（OS 密钥库、后端托管）是有意的设计，详见 Keep sensitive data private。

【免费下载链接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.项目地址: https://gitcode.com/GitHub_Trending/op/openhuman