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 常驻。
OpenHuman 不是「上传一段视频生成数字人」的 Python 推理项目,而是常驻桌面的 Agent harness:UI 优先、几分钟内完成账号连接与 Memory Tree 构建,后台每约 20 分钟 auto-fetch 拉取邮箱/日历/仓库等上下文,再经 TokenJuice 压缩后喂给模型路由。与终端优先的 OpenClaw、Hermes 相比,它强调少配 API、多接 OAuth、记忆在本地 SQLite + Markdown 金库。
本文结构对齐完整安装大纲:环境 → 签名安装 → 首次验收 → Ollama/集成进阶 → 主机选型。若你已在跑 Hermes 保姆级安装文 或 OpenClaw 生产部署,可把 OpenHuman 当作「带脸、带记忆树」的桌面层,与 NodeMini 远程 Mac 组合使用。
痛点:误用旧教程 pip install -r requirements.txt,与当前桌面发行版无关。
痛点:直接 curl | bash 安装,无法验证脚本完整性(官方已标注风险)。
痛点:连接 Gmail/Notion 后 Agent 仍「失忆」——未完成首轮 sync 或 vault 路径错误。
痛点:Linux Wayland 下 AppImage 闪退(社区 issue #2463)。
痛点:笔记本合盖,auto-fetch 与 Meet 代理中断。
本文交付:六步从签名包安装到 Memory Tree 验收的清单。
OpenHuman 为原生桌面应用,不强制 NVIDIA GPU;本地 Ollama 路径在 Apple Silicon 上更常见。下表综合官方 README 与 Early Beta 社区反馈(非 SLA):
| 配置项 | 最低要求 | 推荐(7×24 + 多集成) |
|---|---|---|
| 操作系统 | macOS 12+ / Win10+ / Ubuntu 20.04+ amd64 | macOS 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。」
# 方式 A:官网 DMG(主机器推荐,可验开发者签名) # https://tinyhumans.ai/openhuman # 方式 B:Homebrew(走 bottle 哈希链) brew tap tinyhumansai/core brew install openhuman
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
不推荐默认路径:curl … install.sh | bash 脚本无独立签名校验,官方 README 明确建议优先 DMG / Homebrew / apt / 签名 MSI。若必须用脚本,等 #2620 的 GPG 验证流程发布后再用。
下载并安装:从 tinyhumans.ai/openhuman 或 GitHub Releases 取对应平台安装包;Windows 用签名 .msi。
首次启动:完成账号登录(默认走 OpenHuman 托管的模型路由与 Composio OAuth 代理;可在设置中切换 BYO Key)。
连接 1–2 个集成:建议先 Gmail + GitHub 或 Notion,观察 OAuth 向导是否成功。
等待首轮 auto-fetch:约 20 分钟周期;在 Memory Tree / Obsidian vault 目录应出现 ≤3k token 的 Markdown 块。
验收对话:问「总结我本周日历与未读邮件要点」——若回答引用本地上下文,说明 sync 生效。
(可选)本地模型:设置 → Model Routing → Ollama,确保本机 ollama serve 已跑(可参考站内 Ollama × 租赁 Mac 指南)。
| 报错 / 现象 | 原因 | 处理 |
|---|---|---|
| AppImage 启动即崩溃 | Wayland / sharun 兼容 | 改用 .deb 包或文档中的环境变量 workaround |
| 集成连上但 Agent 无上下文 | 首轮 sync 未完成 | 等待 auto-fetch 周期,检查 vault 是否写入 |
| OAuth 反复失败 | 系统时间漂移 / 代理拦截 | 校准 NTP,放行 tinyhumans.ai 与 Composio 域名 |
本地推理:OpenHuman 支持通过 Ollama 跑部分 on-device 工作负载,敏感步骤可不出云。跨 Agent 记忆:若你已部署 agentmemory,可在 config.toml 设 memory.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 |
远程 Mac 提示:租一台独占 Mac Mini 后,用 VNC/屏幕共享完成首次 OAuth,日常可用 SSH 维护 Ollama 与磁盘;安装步骤与本地一致。
.md 金库,单块约 ≤3k token。若你只是周末体验桌面 mascot,本机安装足够;一旦要让 Gmail/日历/仓库上下文每天自动沉淀,合盖休眠与家用断网会把「几分钟上手」打回「几周重新喂数据」。先 月租验证 30 天工作流 再决定是否自购 Mac Mini,决策成本最低。
低配 VPS 无 GUI、邻居超售、树莓派磁盘 IO,都不适合作为 OpenHuman 主战场——而用户只会觉得「Agent 又忘了我是谁」。对需要稳定 7×24 桌面 Agent、本地 vault 与 Ollama 统一内存的生产环境,NodeMini 的 Mac Mini M4 云端租赁通常比「将就的笔记本 + 手动重启」更省心:你专注记忆复利,而不是半夜修 OAuth。
不是。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 与远程桌面问题见 帮助中心。