如何把 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 持久化的所有内容都在一个文件夹里平台数据文件夹macOS / Linux~/.openhuman/Windows%USERPROFILE%\.openhuman\文件夹内部与迁移直接相关的内容如下这是源文档给出的完整对照决定了一次文件夹拷贝会带走什么、不会带走什么内容位置数据文件夹内文件夹拷贝会带走Memory Tree数据库…/memory_tree/chunks.db会Obsidian vault可读记忆…/wiki/会Persona 与行为SOUL.md、IDENTITY.md、HEARTBEAT.md会Config模型、供应商、路由、自治级别config.toml会会话历史sessions/、session_raw/会审批历史approval/approval.db会OS 存储的密钥session token、部分本地密钥操作系统密钥库Keychain / Credential Manager / Secret Service不在该文件夹不会登录时重新建立集成访问Gmail、Slack 等由后端托管绑定你的账号不会登录时重新连接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如果你用本地 AIOllama 已安装在新机器上模型重新拉取后 Local AI 报告ready。迁移后出问题的对照排查现象原因处理新机器从零开始没有记忆数据文件夹没放在正确位置或拷贝时应用还在运行退出应用把文件夹放到~/.openhuman/或%USERPROFILE%\.openhuman\重新启动已登录但集成是断开的集成访问绑定账号/后端不在文件夹里在 Settings 中逐个重连每个一次 OAuth 点击新电脑上本地模型不工作Ollama / LM Studio 和权重不在新机器上安装运行时并让模型重新拉取参见 local model guide助手丢了性格SOUL.md/IDENTITY.md没有被拷贝拷贝整个数据文件夹而不只是数据库新机器上登录卡住与迁移无关的 auth/handler 问题参见下文登录卡住时的进一步排查登录卡住时的进一步排查若登录流程卡住先按 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_statusNotRegistered|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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考