2026 OpenHuman 完整安装与配置指南:
保姆级从零到跑通与 Mac Mini 常驻选型

2026 年 OpenHuman(TinyHumans,GPL-3.0)把「个人 AI」做成本地优先的桌面 Agent:Rust + Tauri 壳、SQLite Memory Tree、Obsidian 兼容知识库,以及 Gmail/Notion/GitHub 等 118+ 一键 OAuth 集成。若你被网上过时的「pip + 数字人权重」教程误导,或卡在安装签名、首次同步、Ollama 本地模型,这篇按官方 README 整理的 Runbook 帮你从下载到可用 Agent,并对比 MacBook / VPS / Mac Mini M4 月租 谁适合 7×24 常驻。

01

OpenHuman 是什么?为什么 2026 年值得装

OpenHuman 不是「上传一段视频生成数字人」的 Python 推理项目,而是常驻桌面的 Agent harness:UI 优先、几分钟内完成账号连接与 Memory Tree 构建,后台每约 20 分钟 auto-fetch 拉取邮箱/日历/仓库等上下文,再经 TokenJuice 压缩后喂给模型路由。与终端优先的 OpenClaw、Hermes 相比,它强调少配 API、多接 OAuth、记忆在本地 SQLite + Markdown 金库

本文结构对齐完整安装大纲:环境 → 签名安装 → 首次验收 → Ollama/集成进阶 → 主机选型。若你已在跑 Hermes 保姆级安装文OpenClaw 生产部署,可把 OpenHuman 当作「带脸、带记忆树」的桌面层,与 NodeMini 远程 Mac 组合使用。

  1. 01

    痛点:误用旧教程 pip install -r requirements.txt,与当前桌面发行版无关。

  2. 02

    痛点:直接 curl | bash 安装,无法验证脚本完整性(官方已标注风险)。

  3. 03

    痛点:连接 Gmail/Notion 后 Agent 仍「失忆」——未完成首轮 sync 或 vault 路径错误。

  4. 04

    痛点:Linux Wayland 下 AppImage 闪退(社区 issue #2463)。

  5. 05

    痛点:笔记本合盖,auto-fetch 与 Meet 代理中断。

  6. 06

    本文交付:六步从签名包安装到 Memory Tree 验收的清单。

02

环境要求:最低配置 vs 推荐配置(2026-06)

OpenHuman 为原生桌面应用,不强制 NVIDIA GPU;本地 Ollama 路径在 Apple Silicon 上更常见。下表综合官方 README 与 Early Beta 社区反馈(非 SLA):

配置项最低要求推荐(7×24 + 多集成)
操作系统macOS 12+ / Win10+ / Ubuntu 20.04+ amd64macOS 14+(Apple Silicon)或 Ubuntu 24.04 LTS
内存8 GB(仅云端路由)16–32 GB;本地 Ollama 建议 32 GB+
磁盘约 2 GB 应用 + 缓存50 GB SSD+(Memory Tree + vault 增长)
网络可访问 tinyhumans.ai 与 OAuth稳定低延迟(auto-fetch 与 Meet 代理)
从源码构建Node.js 24+、pnpm 10.10、Rust 1.93(仅贡献者)

「装 OpenHuman 最难的一步,往往不是点安装,而是选一台不会在凌晨掉线的 Mac。」

03

六步落地:签名安装 → 登录 → 集成 → Memory Tree 验收

优先:原生包 / 签名安装包(推荐)

bash · macOS
# 方式 A:官网 DMG(主机器推荐,可验开发者签名)
# https://tinyhumans.ai/openhuman

# 方式 B:Homebrew(走 bottle 哈希链)
brew tap tinyhumansai/core
brew install openhuman
bash · Debian/Ubuntu
sudo apt-get install -y --no-install-recommends 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
warning

不推荐默认路径:curl … install.sh | bash 脚本无独立签名校验,官方 README 明确建议优先 DMG / Homebrew / apt / 签名 MSI。若必须用脚本,等 #2620 的 GPG 验证流程发布后再用。

  1. 01

    下载并安装:tinyhumans.ai/openhuman 或 GitHub Releases 取对应平台安装包;Windows 用签名 .msi

  2. 02

    首次启动:完成账号登录(默认走 OpenHuman 托管的模型路由与 Composio OAuth 代理;可在设置中切换 BYO Key)。

  3. 03

    连接 1–2 个集成:建议先 Gmail + GitHub 或 Notion,观察 OAuth 向导是否成功。

  4. 04

    等待首轮 auto-fetch:约 20 分钟周期;在 Memory Tree / Obsidian vault 目录应出现 ≤3k token 的 Markdown 块。

  5. 05

    验收对话:问「总结我本周日历与未读邮件要点」——若回答引用本地上下文,说明 sync 生效。

  6. 06

    (可选)本地模型:设置 → Model Routing → Ollama,确保本机 ollama serve 已跑(可参考站内 Ollama × 租赁 Mac 指南)。

常见报错对照

报错 / 现象原因处理
AppImage 启动即崩溃Wayland / sharun 兼容改用 .deb 包或文档中的环境变量 workaround
集成连上但 Agent 无上下文首轮 sync 未完成等待 auto-fetch 周期,检查 vault 是否写入
OAuth 反复失败系统时间漂移 / 代理拦截校准 NTP,放行 tinyhumans.ai 与 Composio 域名
04

进阶:Ollama、agentmemory 与 7×24 主机怎么选

本地推理:OpenHuman 支持通过 Ollama 跑部分 on-device 工作负载,敏感步骤可不出云。跨 Agent 记忆:若你已部署 agentmemory,可在 config.tomlmemory.backend = "agentmemory",与 Cursor/Codex 等共用存储(见官方 GitBook)。

要把 OpenHuman 当成「永远在线的个人参谋」,主机必须扛住后台 sync、语音与 Meet 代理。下表为选型参考:

平台7×24 可用性Memory Tree 复利适合场景
个人 MacBook合盖即断auto-fetch 频繁中断试用 / 演示
Linux VPS 无 GUI在线率高缺原生桌面与 Tauri 体验不推荐作主环境
Mac Mini M4 月租机房托管常在线GUI + Ollama UMA + vault 本地盘多集成 + 后台 Agent
info

远程 Mac 提示:租一台独占 Mac Mini 后,用 VNC/屏幕共享完成首次 OAuth,日常可用 SSH 维护 Ollama 与磁盘;安装步骤与本地一致。

05

可引用参数与结论:装完 OpenHuman 后主机怎么选

  • 当前版本线:GitHub 发布页 v0.56.x 量级(2026-05/06,Early Beta,接口可能变)。
  • 集成规模:官方文档口径 118+ 第三方连接,默认 Composio 托管 OAuth。
  • 记忆架构:SQLite Memory Tree + Obsidian 兼容 .md 金库,单块约 ≤3k token。
  • TokenJuice:工具输出经压缩后再进模型,文档称最高约 80% token 节省(随内容类型变化)。

若你只是周末体验桌面 mascot,本机安装足够;一旦要让 Gmail/日历/仓库上下文每天自动沉淀,合盖休眠与家用断网会把「几分钟上手」打回「几周重新喂数据」。先 月租验证 30 天工作流 再决定是否自购 Mac Mini,决策成本最低。

低配 VPS 无 GUI、邻居超售、树莓派磁盘 IO,都不适合作为 OpenHuman 主战场——而用户只会觉得「Agent 又忘了我是谁」。对需要稳定 7×24 桌面 Agent、本地 vault 与 Ollama 统一内存的生产环境,NodeMini 的 Mac Mini M4 云端租赁通常比「将就的笔记本 + 手动重启」更省心:你专注记忆复利,而不是半夜修 OAuth。

FAQ

常见问题

不是。TinyHumans 的 OpenHuman 是 Rust/Tauri 桌面 Agent,安装方式为 DMG/Homebrew/apt,而非 git clone + pip install 训练数字人权重。请认准 github.com/tinyhumansai/openhuman

NodeMini 提供独占 Mac Mini M4 按月租赁,价格见 租赁价格说明。OpenHuman 订阅与第三方 LLM 费用仍由你向 TinyHumans / 模型商自行支付。

可以。默认云端模型路由;本地路径可接 Ollama 利用 Apple Silicon Metal。SSH 与远程桌面问题见 帮助中心