pip install + 数字人 Demo」教程去找 OpenHuman，多半会装错项目——2026 年官方产品来自 tinyhumansai/openhuman，是桌面端 Agent + Memory Tree 长期记忆，而非 Python 换脸流水线。本文给可执行结论：① macOS / Linux / Windows 优先 Homebrew、apt、MSI 原生包；② 登录后跑通第一次 Memory Tree 请求；③ 分清本地库与托管 OAuth 边界；④ 大邮箱 + 本地模型建议 16GB+。结构含环境矩阵、六步 Runbook、报错表与 M4 宿主建议。
2026 OpenHuman 是什么？和 OpenClaw、Hermes 怎么选
OpenHuman（GPL-3.0，Rust 核心）定位是住在桌面的个人 AI 超脑：通过一键 OAuth 连接 100+ 应用，把邮件、文档等沉淀进本地 SQLite 与 Obsidian 兼容的 Markdown 库，形成可检索的 Memory Tree。与 OpenClaw 双栈文里强调的「频道网关 + ClawHub」不同，OpenHuman 更偏知识摄入与记忆压缩（官方称 token 成本可降约 80% 量级，以实际账单为准）。
对比 OpenClaw：OpenClaw 擅长 Telegram/微信等渠道 7×24 Gateway；OpenHuman 擅长桌面侧记忆树与 118+ 集成，二者可并存但资源会抢内存。
对比 Hermes：Hermes 是 CLI + hermes gateway + Skill 目录；OpenHuman 是图形化 onboarding，默认仍用托管登录与模型路由（Advanced 可改 RPC）。
别装错：无需 conda create、checkpoints/*.pth 或 run_demo.py——那些属于另一类「数字人视频」模板，与官方仓库无关。
版本线：截至 2026 年 6 月，Release 已到 v0.56.x 早期 Beta，安装后请在应用内检查更新。
OpenHuman 安装环境要求：macOS、Windows、Linux 对照
| 项目 | 最低要求 | 推荐（大邮箱 + 本地模型） |
|---|---|---|
| 系统 | macOS 12+、Windows 10+、Ubuntu 20.04+ | macOS 14+（Apple Silicon）或 Ubuntu 24.04 LTS |
| 内存 | 4 GB（官方文档） | 16 GB+（大量 Gmail/仓库摄入 + 同机本地推理） |
| 磁盘 | 约 2 GB 应用与索引 | ≥ 50 GB SSD（Memory Tree + Markdown 库增长） |
| GPU | 非必须（默认托管模型） | Apple Silicon / NVIDIA 仅在同机跑本地模型时需要 |
| 网络 | 登录、OAuth、模型 API | 稳定出口；国内用户建议原生包 + 镜像加速 npm |
| 安装路径 | 完整性校验 | 适用场景 |
|---|---|---|
| Homebrew / apt / MSI | 走系统包管理器签名链 | 生产首选 |
| npm -g openhuman | SHA-256 校验平台二进制 | 已有 Node ≥18 的开发者 |
| curl | bash 脚本 | 无独立脚本签名，官方标为不推荐 | 仅临时试用 |
| Git 源码编译 | 需 Rust 工具链 | 贡献者与高级用户 |
OpenHuman 保姆级安装：六步 Runbook（四平台）
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
选安装通道：macOS 用 Homebrew；Linux amd64 用 apt；Windows 从 GitHub Releases 下载签名 .msi；跨平台也可用 npm install -g openhuman（需 Node ≥18）。
验证二进制：终端执行 openhuman --version，或在应用菜单打开 OpenHuman 桌面端，确认 About 中版本 ≥ v0.53。
首次启动与登录：首屏「Sign in! Let's Cook」支持社交登录；Advanced 可填自定义 core RPC URL（自托管后端才需要）。
连接数据源：按 onboarding 连接 Gmail 等；数据写入本机 Memory Tree，Markdown 库可与 Obsidian 工作流对接。
跑通第一次请求：对 Memory Tree 提一个可验证问题（例如「总结上周某标签邮件」），确认回答引用了本地索引而非空泛幻觉。
更新与回滚：brew/apt 走包管理器升级；Release 页可下载上一版 MSI/dmg 回滚；Beta 期建议固定小版本做生产钉扎。
边界提醒：Memory Tree 数据库、Markdown vault、工作区配置在本机；默认仍依赖 OpenHuman 托管的登录、模型路由与部分 OAuth 代理。自托管需走 Advanced / 文档中的 custom setup。
OpenHuman 配置进阶：本地模型路由、性能与报错速查
安装不等于「配置完成」。以下三项决定长期使用体验：摄入规模、模型路由、磁盘与后台常驻。
| 报错 / 现象 | 常见原因 | 处理 |
|---|---|---|
| 登录一直转圈 | 网络或托管服务不可达 | 换网络、检查系统代理；Advanced 填可用 RPC |
| OAuth 授权失败 | 浏览器拦截或账号权限 | 用系统默认浏览器重试；检查 Workspace 管理员策略 |
| 摄入极慢 / 磁盘暴涨 | 大邮箱全量同步 | 先缩小邮箱范围；磁盘预留 ≥50GB；16GB 内存 |
| 本地模型 OOM | 4GB 机器跑 7B+ | 改用托管路由，或换 16GB+ / Apple Silicon 主机 |
command not found: openhuman | PATH 未包含 brew/npm 前缀 | 重开终端；brew link openhuman 或核对 npm global bin |
本地模型：官方 GitBook 提供 local AI / model routing 路径；同机跑 Ollama 时与 OpenClaw 栈类似，M4 24GB 更从容，详见租赁 M4 双栈指南。
低显存模式：无独显时依赖 CPU / Metal 路径，优先托管模型，避免与全量邮箱摄入并行峰值。
卸载：包管理器卸载应用后，手动清理 Memory Tree 数据目录与 Markdown vault（路径见应用设置），避免残留占满磁盘。
安装之后：7×24 摄入与 Mac Mini M4 宿主硬数据
社区规模：截至 2026 年 6 月，openhuman GitHub Star 约 2.9 万（快速增长中），以桌面 Beta 迭代为主。
功耗：M4 空闲约 4–6W，后台同步 + 本地 7B 典型 18–28W，适合作为记忆摄入专用机。
统一内存：16GB UMA 下桌面 Agent + SQLite FTS + 小模型回落，较 4GB x86 VPS 更少 swap 导致的索引损坏风险。
笔记本合盖会中断邮箱增量同步；纯 Windows 桌面又无 launchd 式轻量守护——若你要让 Memory Tree 持续长胖 且偶尔挂本地模型，MESHLAUNCH 的 Mac Mini M4 云端裸金属月租通常是更优解：与本地相同的 brew 路径、SSH 维护、退租前可打包数据目录迁移。先看租赁价格页按日试跑，边界见帮助中心。
不需要。请用 Homebrew、apt 或 MSI 安装桌面/CLI 二进制；pip install -r requirements.txt 属于其他「数字人视频」项目模板，与 tinyhumansai 官方仓库无关。
可以。默认托管模型即可跑通 Memory Tree；若同机 Ollama，Apple Silicon 的 Metal 路径更现实。可先租 M4 节点做 24 小时摄入压测。
项目为 GPL-3.0，闭源商用分发需遵守 Copyleft 义务；企业内部自用仍建议阅读官方许可与托管服务条款，必要时联系 tinyhumans 商业支持。