2026 OpenHuman 保姆级安装教程：macOS / Windows / Linux 签名安装、Ollama 本地推理与 Memory Tree 排错

约 18 分钟阅读 · MACCOME

📌 若你在 2026 年 5 月看到 TinyHumans OpenHuman 冲上 GitHub 热榜、却分不清「该用 brew 还是 curl|bash」「Ollama 怎么接」「Memory Tree 有没有写入」，本文就是面向当天要跑通桌面 Agent 的保姆级 Runbook。谁适合读：要在 macOS、Windows 或 Linux 上安装 v0.56.x 桌面版、并可选接本地 Ollama 的开发者与个人用户。你会得到：三平台签名安装路径、八步验收、12 项报错对照与 7×24 常驻主机结论。结构：痛点 → 环境表 → 八步落地 → 硬数据 → 平台对比 → FAQ。

六道安装坑：为什么 OpenHuman 不是「pip install 就能跑」

很多人把 OpenHuman 误当成 Python 仓库克隆 + requirements.txt 的老路子——那是通用教程模板，与官方产品形态不符。2026 年主线是 TinyHumans 发布的 Rust + Tauri 桌面应用（GPL-3.0），UI 优先、几轮点击即可 onboarding。真实卡点往往是下面这些：

  1. 在主力机上直接 curl | bash：脚本会拉远程代码并执行；安全社区与独立评测均建议主力机改用 DMG / MSI / brew / apt 签名链，先审计再装。
  2. 混用安装渠道：同一台机器既 brew 又 npm 全局 openhuman，PATH 冲突导致「已装却打不开」。
  3. 跳过 macOS TCC 授权：屏幕智能、Meet 数字人、键盘补全依赖屏幕录制 / 辅助功能；拒绝权限后以为「功能坏了」。
  4. 只装应用、未拉 Ollama 模型：设置里选了 Local AI，但 ollama list 为空，推理一直超时。
  5. 把 Memory Tree 当云同步：数据在本地 SQLite + Obsidian 兼容 vault；换机未打包目录就「记忆丢了」。
  6. 笔记本合盖当 7×24：后台思考与 Webhook 需要桌面会话在线；合盖挂起后集成事件堆积。

与 OpenClaw 的一句话差异：OpenClaw 强在 CLI、Gateway 与 Telegram/WhatsApp 渠道运维；OpenHuman 强在桌面 GUI、Memory Tree、118+ 集成（Gmail/Slack/Notion 等）与语音 / Google Meet 数字人。租赁场景下的双品对比见站内 OpenClaw & OpenHuman 云 Mac 部署文——本篇只解决「装得上、验得过、接得住本地模型」。

环境要求：最低配置与推荐生产档

OpenHuman 早期 Beta（2026 年 5–6 月）对资源的要求高于普通聊天客户端：要预留本地 vault、可选 Ollama 与屏幕智能缓存。下表按「仅云端路由」与「本地 13B + Memory Tree」两档列出。

项目 最低（云端模型） 推荐（本地 Ollama + 集成）
操作系统 macOS 12+、Win10 22H2+、Ubuntu 20.04+ macOS 14+（Apple Silicon）/ Win11 / Ubuntu 24.04
CPU / 芯片 4 核 x86_64 或 Apple M1 Apple M4 / M4 Pro（统一内存利于 Ollama）
内存 8 GB 16 GB（13B Q4）；70B 级请 64 GB+ 或纯云端
磁盘 5 GB（应用 + vault 起步） 40 GB+（Ollama 模型 + 日志 + 集成缓存）
GPU 无独显亦可（走 API） NVIDIA 可选；Apple Silicon 用 Metal 经 Ollama
网络 可访问订阅路由与集成 OAuth 稳定低延迟；大模型首次拉取建议机房带宽
warning

安全提示：生产环境优先从 tinyhumans.ai/openhuman 或 GitHub Releases 下载已签名安装包；curl | bash 仅建议在隔离 VM 或一次性测试机使用。

八步落地：三平台安装 → 首次验收 → Ollama → Memory Tree

以下步骤覆盖 macOS / Windows / Linux；远程 Mac 上通过 VNC 或本机控制台操作与本地一致。

  1. 选择安装通道（推荐签名链）：macOS 用 Homebrew；Debian/Ubuntu 用官方 apt 源；Windows 用 Releases 的 .msi；均需验证开发者签名。
  2. 执行安装：见下方各平台命令块；成功标志为应用出现在启动台/开始菜单，且版本 ≥ v0.56.0（2026 年 5 月线）。
  3. 首次启动与账户：按向导登录/创建 TinyHumans 账户（若使用订阅模型路由）；可跳过部分集成稍后再绑。
  4. 系统权限（macOS 必做）：在「系统设置 → 隐私与安全性」为 OpenHuman 打开辅助功能、屏幕录制、麦克风（若用语音/Meet）。
  5. 冒烟对话：在桌面输入「总结我桌面上的待办」类轻量任务，确认模型路由有响应（云端或本地）。
  6. 安装并启动 Ollama：brew install ollama 或官网安装包 → ollama serve → ollama pull qwen2.5:7b（示例）。
  7. 在 OpenHuman 启用 Local AI：设置 → Model Routing → Local AI，Base URL 填 http://127.0.0.1:11434，选择已 pull 的模型；保存后重试同一句 prompt。
  8. 验收 Memory Tree：完成一次带文件/邮件上下文的任务后，在 vault 目录（Obsidian 兼容）查看是否生成节点；Settings 里可查看 SQLite 记忆占用。

分平台安装命令（2026 官方口径）

bash · macOS
# 推荐：Homebrew tap（走系统签名链）
brew tap tinyhumansai/core
brew install openhuman

# 或：官网 DMG / GitHub Releases 手动安装
# https://github.com/tinyhumansai/openhuman/releases/latest

# 仅测试机可选（不推荐主力机）
# curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
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
powershell · Windows
# 推荐：下载已签名 .msi
# https://github.com/tinyhumansai/openhuman/releases/latest

# 测试机可选（需先审阅脚本）
# irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
bash · Ollama 本地推理
brew install ollama    # 或 https://ollama.com/download
ollama serve           # 保持后台运行
ollama pull qwen2.5:7b # 16GB 统一内存友好
ollama list            # 确认模型 READY

# OpenHuman 设置内：Local AI → http://127.0.0.1:11434

可引用硬数据：版本、Stars 与 Memory Tree 机制

  • GitHub Stars（2026-06 口径）：约 7,800+，GPL-3.0；稳定发行线 v0.56.0（2026-05-27），Beta 期迭代快，装前请在 Releases 核对 tag。
  • 架构选型：Rust 核心 + Tauri 桌面（非 Electron），社区评测称空闲内存显著低于典型 Electron Agent 客户端——适合长期开着的个人助理场景。
  • Memory Tree：本地 SQLite + Obsidian 兼容 vault，上下文经 canonicalize 折叠进 ≤3k token 树节点；官方宣称记忆容量设计可达十亿 token 级索引（本地存储，非云训练）。

12 项常见报错与现象对照表

报错 / 现象 原因 处理
安装后无法打开 / 闪退 混装渠道或残留旧版 只保留一种安装方式；完全卸载后重装签名包
macOS「已损坏」提示 Gatekeeper 拦截未公证副本 仅用官网/Releases；勿用第三方网盘 repack
屏幕智能无响应 未授屏幕录制权 系统设置 → 隐私 → 屏幕录制 → 勾选 OpenHuman
Local AI 一直 Pending Ollama 未启动或端口错 ollama serve；URL 用 127.0.0.1:11434
connection refused（Ollama） 防火墙 / 仅监听远端 本机调用禁止暴露 11434 到公网
推理极慢或 OOM 模型大于可用内存 改 7B/13B Q4；或关本地走云端路由
Gmail/Slack 连不上 OAuth 未完成或企业策略拦截 用设置向导重走授权；检查代理
Memory Tree 空白 未产生可索引上下文 先完成一次带文件/邮件的任务；查 vault 路径
Meet 数字人无画面 摄像头/麦克风未授权 检查 TCC 与浏览器插件冲突
Linux 无 GUI 装服务器版无桌面 OpenHuman 需桌面会话；无头请用 OpenClaw 等 CLI Agent
升级后配置丢失 未备份用户目录 升级前打包 Application Support 下 OpenHuman 数据
订阅模型 429 路由限流 切换 Local AI 或稍后重试；检查账户额度

部署平台对比：笔记本、Linux 桌面与租 Mac Mini M4

装通 OpenHuman 解决「能对话」；集成同步 + Memory Tree 复利解决「像认识你」——后者依赖主机长期在线且具备稳定 GUI 会话。

平台 7×24 可用性 本地 Ollama 适合
个人 MacBook 合盖即断 M 系列 Metal 体验最佳 POC、当日调试
Linux 台式机 可常驻但需桌面 NVIDIA CUDA 友好 已有显卡的工作站
x86 云 VPS 高可用 无官方 GUI 路径 不推荐跑 OpenHuman
租 Mac Mini M4 机房级在线 UMA + 远程 VNC 排错 要 Meet/屏幕智能 + 本地 13B 生产

收束：签名装通只是第一步，常驻才决定 Memory Tree 是否「越用越像你」

按本文八步，多数读者可在 45–90 分钟 内完成 OpenHuman 桌面首通与 Ollama 本地冒烟。三条替代方案的短板也很明确：(a) 笔记本合盖会中断 Webhook 与后台思考；(b) 无桌面 Linux 服务器无法承载 Tauri GUI；(c) 自购 Mac Mini 要把硬件折旧、电费与 7×24 噪音压在自己身上。

若你已验证 OpenHuman 的 Memory Tree 与集成能替你省重复劳动、又希望 固定月费、SSH/VNC 十分钟上岗、退租前可打包 vault 目录，MACCOME 独占 Mac Mini M4 云节点通常是更优解：真实 Apple Silicon、与 brew/Ollama 命令完全兼容，并适合作为与 OpenClaw 并行的第二台常驻桌面。双品租赁路径可继续读 云 Mac 双 Agent 文，并在 租赁价格页 按区域下单。

常见问题

OpenHuman 必须用终端安装吗？

不必。官方定位 UI-first：DMG/MSI/brew/apt 均可无终端完成。终端脚本适合自动化测试机。

能和 OpenClaw 装在同一台 Mac 上吗？

可以，注意内存与磁盘（Ollama 模型 + OpenClaw Gateway）。OpenClaw 渠道运维见站内相关博客；要 7×24 桌面+CLI 并存时建议 租赁专用节点 或 32GB 档。

M2/M3/M4 有区别吗？

均支持；本地 Ollama 吞吐随统一内存线性改善。16GB 跑 13B Q4 较稳，更大模型请升配或走云端路由。

退租前如何迁移 OpenHuman 数据？

打包 macOS「应用程序支持」下 OpenHuman 目录与 Obsidian vault 路径即可。MACCOME 退租前支持自助清机；操作说明见 帮助中心。