2026 OpenHuman 完整安装配置指南：从 Homebrew / apt 到 Memory Tree 首跑，租 Mac 7×24 常驻

OpenHuman 由 TinyHumans AI 维护，技术栈以 Rust 与 Tauri 为主（仓库语言占比 Rust 约 69%、TypeScript 约 26%，以 GitHub 页面为准），许可为 GNU GPL-3.0。与每次对话都「失忆」的网页聊天不同，它把 Gmail、日历、代码仓库等接入同一分层 Memory Tree，让后续提问能引用你真实上下文。官方文档强调：Memory Tree 数据库、Markdown 保险库、工作区配置与本地运行态留在本机；默认安装仍会走 OpenHuman 托管的登录、模型路由与部分集成代理——若你要完全自托管，需在 Advanced 面板指向自建 core RPC（多数用户可跳过）。

本教程的「成功」定义是：桌面应用可启动、完成 Sign-in onboarding、至少连接一个数据源（本文以 Gmail 为例）、对 Memory Tree 发出第一条请求并看到基于你数据的回复。进阶能力（本地模型路由、118+ 第三方集成、Web UI/API）在首跑稳定后再开，避免安装阶段同时排障 OAuth、磁盘与 GPU。

与 05-29 双框架文 的差异：那篇覆盖 OpenClaw 消息渠道 + Ollama 本地推理 + OpenHuman 同机部署；本篇只深挖 OpenHuman 单机安装与配置，适合「先把桌面助理装对」再考虑与 OpenClaw 并行。

中文社区里大量「OpenHuman 数字人」教程实为其他仓库的 Python 推理脚本（pip install -r requirements.txt、checkpoints/*.pth），与 TinyHumans 官方桌面产品不是同一代码库。按错教程会出现：装完没有 GUI、找不到 Memory Tree、或误以为必须 NVIDIA CUDA。真实 OpenHuman 的交付物是签名安装包或包管理器二进制，命令行入口为 openhuman（若 PATH 已配置）。

• 渠道选择错误：官方 README 明确：优先 Homebrew / signed apt 等原生包；curl … | bash 脚本无独立签名校验，仅作备选。
• 内存与磁盘低估：文档建议 4GB+ RAM 最低，摄取超大邮箱或同机跑本地模型时推荐 16GB+；Memory Tree 与邮件索引会持续增长。
• 隐私边界误解：以为「全本地」等于无需登录；默认仍需账号完成 sign-in 与托管集成 OAuth，需阅读 GitBook 中 local vs managed 说明。
• 笔记本休眠：桌面助理在合盖后暂停同步，用户以为「安装坏了」；生产应迁移到始终在线主机。
• 与 Hermes 角色混淆：Hermes 偏多平台网关与技能自进化；OpenHuman 偏桌面个人超智能 + Memory Tree，二者可同 Mac 不同用户并行，但勿争用同一数据目录。

在下载安装包前，用下表锁定平台与渠道，可减少一半返工。

• 仓库热度：GitHub Star 约 2.9 万+（2026 年 6 月，以页面实时数为准），早期 beta，迭代快。
• 集成规模：官方宣传 118+ 第三方集成（邮件、日历、开发工具等），首跑不必一次全开。
• 许可：GPL-3.0，商用与再分发须遵守 copyleft 义务，企业法务应提前评审。

1. 01
   选定主机：开发可在 MacBook；要 Gmail 持续同步与 Memory Tree 复利，优先 NUKCLOUD 云端 Mac 或自购 Mini。在 控制台 获取 SSH，创建专用 macOS 用户，预留 50GB+ 数据盘。
2. 02
   安装原生包（macOS 示例）：安装 Homebrew 后执行下方 tap + install；Linux 用户改用 signed apt 或 Releases 中的 .deb。
3. 03
   验证二进制：终端运行 openhuman --version（或从应用程序文件夹启动 GUI）；若命令未找到，检查 PATH 与安装日志。
4. 04
   首次启动与 Sign-in：打开应用，完成「Sign in! Let's Cook」；社交登录或企业 SSO 按提示操作。Advanced 中自定义 core RPC URL 仅在自托管后端时填写。
5. 05
   连接 Gmail：在 onboarding 或设置中授权 Gmail；确认本地 Memory Tree 目录可写（勿指向会被系统清理的 /tmp）。
6. 06
   Memory Tree 首跑：用自然语言提问一件仅能从你邮箱/日历推断的事实；记录响应延迟与引用片段。成功后备份工作区目录并 pin 当前 Release 版本。

brew tap tinyhumansai/core
brew install openhuman
openhuman --version

sudo apt-get install -y gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

安装后核心配置围绕数据落盘位置与模型路由。Memory Tree 会把邮件线程、仓库片段等索引为可检索结构；Markdown 保险库适合人工审阅与导出。官方 Getting Started 建议：大邮箱初次同步可能耗时数十分钟到数小时，期间保持应用前台或允许后台网络，磁盘 IO 会明显升高。

本地 vs 托管边界（务必理解）：本机持有 Memory Tree 数据库与工作区；默认 sign-in、部分 OAuth 与模型路由仍依赖 TinyHumans 托管服务。若合规要求数据不出境，需评估 Advanced 自定义 RPC 与帮助中心中的企业路径，而非假设「开源等于完全离线」。

进阶（首跑稳定后再开）：在设置中启用本地模型路由（同机推理会再占 8–16GB 统一内存，Apple Silicon 上体验最佳）；按需打开更多集成，每增一项集成都会扩大 OAuth 面与后台同步负载。源码构建路径需 Node 24+、pnpm 10.10+、Rust 1.93+ 与子模块初始化——仅推荐给要贡献 PR 的开发者，日常用户用 Releases 即可。

当你需要 OpenHuman 在夜间继续摄取邮件、且不想把个人笔记本长期插电时，共享分钟池式 macOS VPS 常伴带宽抖动与邻居 steal，导致 OAuth 刷新失败或索引损坏；家庭宽带上的自购 Mini 则要自己处理断电与备份。对要把 Memory Tree 当「第二大脑」长期复利、又希望磁盘与 SSH 边界可审计的团队，NUKCLOUD 多区域裸金属 Mac / 云端 Mac Mini M4 通常比「笔记本 + 五美元 VPS」更省总账：在云端 Mac 用与本地相同的 Homebrew 路径安装，通过 VNC 或屏幕共享完成 GUI onboarding，再把工作区目录放在租户持久卷上。可从 定价页 按小时 pilot，验证 Gmail 同步 72 小时稳定性后再扩大集成面。