2026 OpenHuman 完整安装与配置指南：
从下载到 Ollama 本地推理与 7×24 常驻

OpenHuman（TinyHumans AI 开源）是一款桌面优先的个人 AI Agent：把 Gmail、日历、GitHub 等接入后，通过 Memory Tree 与 Obsidian 兼容的 Markdown 库把上下文留在本机 SQLite 里，并可用 Ollama 做可选本地推理。很多人搜「OpenHuman 安装」时会被过时的 Python 克隆教程带偏——官方 2026 路径其实是 Homebrew / apt / 签名安装包，而不是 pip install -r requirements.txt。

本文面向想在 macOS、Windows 或 Linux 上从零跑通 OpenHuman 的初学者与开发者：先拆解安装痛点与宿主对照，再给原生包安装 → 首次启动 → 账号与集成 → Ollama → Memory Tree 验收 → 7×24 宿主 六步清单。读完应能独立完成安装验收，并判断该把数据目录放在本机还是不休眠的 Mac Mini 上。

01 OpenHuman 安装前必须知道的痛点：不是「git clone + pip」那条路

OpenHuman 基于 Rust + Tauri + React 打包为桌面应用（GPL-3.0，Early Beta）。与 OpenClaw（终端 Gateway + Node 生态）或 Hermes Agent（安装器拉 Python/Node 到 ~/.hermes/）不同，终端用户不需要自己编译 Python 环境；从源码贡献才需要 Node 24+、pnpm、Rust 等工具链。

  • 教程过时：网上部分「数字人」文章仍写 conda create、checkpoints/*.pth，那是另一类项目模板，与 tinyhumansai/openhuman 无关。
  • 脚本安装无签名校验：官方 README 明确警告 curl … | bash 无法检测脚本篡改，生产环境应优先 Homebrew bottle / 签名 apt / MSI。
  • 托管与本地并存：Memory Tree 与工作区在本地，但默认登录、模型路由、部分 OAuth 会走 OpenHuman 托管后端；完全离线需按文档切换 BYO 模型与 Composio 直连模式。
  • 合盖即断：20 分钟一轮的 auto-fetch 与后台记忆压缩依赖主机清醒；笔记本睡眠会导致上下文同步中断。
  • Linux Wayland：AppImage 在部分 Wayland 环境可能启动失败，Debian/Ubuntu 用户应优先 .deb / apt 路径（官方 issue #2463）。

结论先行：安装可在十几分钟内完成；长期体验取决于宿主是否 7×24 在线，以及本地 vault 与 SQLite 是否可备份、可迁移。

安装命令与行为以 TinyHumans 官方文档为准；发版后请再次打开下列链接核对。

tinyhumansai/openhuman on GitHub

OpenHuman Official Documentation

02 OpenHuman 环境要求与部署宿主对照：装在哪台机器最省心

官方提供 macOS（Intel / Apple Silicon）、Windows 10/11、Linux（Debian/Ubuntu amd64、Arch AUR） 安装包。下表用于选型，具体磁盘与内存请以你选择的 Ollama 模型尺寸为准。

OpenHuman 部署宿主对照（2026 实操向）
宿主 7×24 可用性 安装摩擦 Memory Tree / Ollama 典型短板
MacBook 本机 合盖/睡眠易断 低（Homebrew / .dmg） Apple Silicon + Ollama 体验好 auto-fetch 中断、系统更新重启
Windows 台式机 可常开但更新重启多 低（签名 MSI） NVIDIA 可选本地模型 与 macOS 工具链不一致
Linux 桌面 / 无头 服务器级在线率高 中（apt 优于 AppImage） Ollama 官方支持 Linux 无 GUI 时需确认发行版支持
Mac Mini M4 月租裸金属 机房 SLA，目标长期在线 低（SSH + brew） 统一内存适合 7B–14B 级本地模型 需选可信机房与租期

资源参考（结合 Ollama 本地路径）：仅托管模型 + 轻量集成时 8 GB 内存 可试玩；若常驻 Qwen2.5 / Gemma3 7B 级模型并开浏览器类工具，建议 16 GB 及以上统一内存或 RAM。本地数据目录（Memory Tree、vault、SQLite）请预留 10–30 GB SSD，视邮箱与仓库同步量增长。

03 OpenHuman 官方安装路径：Homebrew、apt 与 Release 怎么选

推荐顺序：官网或 GitHub Releases 下载对应平台安装包 → 或使用系统包管理器（带签名链）。仅在无法使用包管理器时再考虑脚本安装。

macOS（Homebrew，官方推荐）：

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

Debian / Ubuntu（签名 apt 源）：

apt-install.sh 
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

Windows：从 GitHub Releases 下载签名 .msi 并安装。

备选（无完整性校验，慎用）：官方 README 提供的脚本安装；发版后请核对仓库是否已发布 GPG 验证流程（issue #2620）。

OpenHuman 官网下载页

04 六步落地：首次启动、集成、Ollama 与 Memory Tree 验收

  1. 完成安装并启动应用：从启动台或应用菜单打开 OpenHuman；若 CLI 已入 PATH，可执行 openhuman --version 核对版本（请以 Releases 页当前 tag 为准）。
  2. 完成引导与账号：按 UI 完成 onboarding；若使用默认托管体验，需登录 OpenHuman 账号以启用模型路由与部分 OAuth；纯本地实验可在设置中切换 BYO / Ollama（见官方 Local AI 文档）。
  3. 安装并启动 Ollama（可选本地推理）：在 macOS / Linux 安装 Ollama，拉取文档推荐的模型（如 Qwen2.5、Gemma3 等，以 gitbook 为准），在 OpenHuman 模型路由中选择本地端点。
  4. 连接 1–2 个数据源做冒烟：优先连接 GitHub 或日历等低敏集成，等待约 20 分钟 auto-fetch 周期，观察 Memory Tree 是否出现新 Markdown 分块。
  5. 验收 Memory Tree 与 vault：在应用内打开 Memory Tree / Obsidian 兼容目录，确认 SQLite 与 .md 文件同步增长；若为空，检查集成授权与网络，而非盲目重装。
  6. 规划 7×24 宿主：需要全天候 auto-fetch 与消息通道时，将实例迁移到禁用睡眠的 Mac Mini（本地或 CALMVPS 裸金属），打包备份整个工作区与配置目录后再切换机器。

若计划在 CALMVPS 裸金属 Mac 上部署：先在 定价页 选定 M4 内存与区域，SSH 登录后执行与本地相同的 brew install openhuman；退租前打包备份 OpenHuman 本地数据目录（含 Memory Tree / vault）。

05 可引用参数、常见报错与 CALMVPS 场景收束

  • 技术栈：Rust + Tauri v2 + React 桌面壳；Memory Tree 使用本机 SQLite，分块约 ≤3k token 写入 Markdown（来源：官方 README / gitbook）。
  • 同步节奏：活跃集成默认约 20 分钟 一轮 auto-fetch 拉取上下文（以文档为准，非实时推送）。
  • TokenJuice：工具输出与网页抓取在进模型前压缩，官方宣称最高约 80% token 节省（实际取决于任务类型，请自行观测账单）。
OpenHuman 常见安装与运行问题
现象 常见原因 处理
按 pip/conda 教程装失败 误用其它项目文档 改用 Homebrew / apt / Release 安装包
Linux AppImage 闪退 Wayland / sharun 兼容 改用 .deb 或文档中的环境变量变通
Ollama 无响应 服务未启动或模型未 pull ollama serve + ollama pull <model>
Memory Tree 一直为空 集成未授权或未到 fetch 周期 检查 OAuth 与等待 20 分钟周期

FAQ 速答：没有独显也可运行——托管模型路径不强制 GPU；本地 Ollama 在 Apple Silicon 上通常比纯 CPU Windows 更顺滑。Mac M 系列请优先 arm64 安装包与 arm64 Ollama 模型。模型下载慢可换镜像网络或在机房侧 Mac 上预先 ollama pull。

把 OpenHuman 装在经常合盖的笔记本上，短板是 auto-fetch 连续性与 Memory Tree 复利；装在廉价跨境 VPS上，短板是缺少官方桌面体验与 GUI 维护成本；只装不备份，短板是换机即丢上下文。对需要保姆级原生安装路径、Ollama 本地推理、20 分钟记忆同步、且要快速升配统一内存的生产环境，CALMVPS 裸金属 Mac Mini M4 月租 通常是更优解：SSH 交付即用，独占 Apple Silicon，按月弹性下单。机型与租期见 CALMVPS 定价页。