2026 年 OpenHuman 保姆级安装与配置全指南：从 0 到跑通 macOS / Windows / Linux 只看这一篇
OpenHuman（tinyhumansai/openhuman）是 2026 年快速走红的 GPL3 桌面 Agent：Rust 核心 + Tauri 壳，带可读 Memory Tree、桌面 mascot 数字人 与 Google Meet 入会能力。本文不聊概念——只给一步都不跳的环境矩阵、三平台安装、首次验证、Ollama 本地与报错表，预计阅读 20 分钟。
1. 为什么选 OpenHuman、本教程能帮你实现什么
OpenHuman 是 GPL3 桌面 Agent（Rust + Tauri）：本地 Memory Tree、桌面 mascot 数字人、可选 Google Meet 入会。与 OpenClaw 网关生态、Hermes Skill 复利不同，它 UI 优先、无需终端 onboarding。本文覆盖：官方包安装 → LLM 配置 → Memory Tree/mascot 验证 → 可选 Ollama。与 OpenClaw 同机部署见《租 Mac 跑双 Agent》。
2. 安装前三类隐性痛点
- 误走源码编译：普通用户用 Homebrew/apt/MSI，勿盲目
git clone。 - LLM 未配：跳过 API Key 会导致 mascot 无响应。
- 合盖中断：subconscious 需 7×24 主机，笔记本常断档。
3. 环境要求与硬件决策矩阵
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 12+、Win10 64 位、Ubuntu 20.04+ | macOS 14+（Apple Silicon）、Win11、Ubuntu 24.04 LTS |
| CPU / 芯片 | x64 四核 | Apple M4 / M4 Pro；或 8 核 x64 + 独显 8 GB |
| 内存 | 8 GB（仅云端 API） | 16 GB（Ollama 7B）；32 GB（多集成 + 本地 13B） |
| 磁盘 | 10 GB 可用 | 50 GB SSD（含 Ollama 模型缓存） |
| 网络 | 可访问 LLM API / OAuth | 稳定低延迟；Meet 代理需可访问 Google |
Apple Silicon 统一内存利于 Ollama 与 Agent 共存；NVIDIA 本地大模型需 CUDA 12+ 与足够 VRAM，否则用云端 API。
4. 安装前准备与路径选型
| 安装路径 | 适用平台 | 完整性校验 | 推荐场景 |
|---|---|---|---|
| Homebrew tap | macOS、Linux | brew 签名链 | 日常用户首选 |
| signed apt | Debian / Ubuntu amd64 | GPG 仓库 | Linux 桌面 / 服务器 |
| 官方 MSI / DMG | Windows / macOS | 发布页签名 | 无包管理器环境 |
| curl install.sh | macOS / Linux x64 | 无（不推荐生产） | 快速试用 |
| 源码编译 | 全平台 | 自验 | 贡献者 / 定制 CEF |
前置：macOS 需 Xcode CLT；Linux 由 apt 自动拉 WebKit/GTK；Windows 直接装 MSI，无需 Python。
5. 核心安装步骤（macOS / Linux / Windows）
macOS（推荐 Homebrew）：
brew tap tinyhumansai/core && brew install openhumanLinux：添加 signed apt 源后 sudo apt install openhuman；Arch 用 AUR openhuman-bin；其他发行版可用 Releases 的 AppImage。
Windows：从 GitHub Releases 安装 signed .msi。快速试用可用 curl | bash 脚本，但生产环境优先 brew/apt/MSI 签名链。
npm（跨平台）：npm install -g openhuman，需 Node ≥ 18，会校验 SHA-256 后释放原生二进制。
6. 首次运行与验证清单
- 启动应用并完成 onboarding（API Key 或 OAuth）。
- 冒烟对话，确认 LLM 有回复。
- 检查 Memory Tree 目录是否生成 Markdown。
- 观察 mascot busy/thinking 动画；开 TTS 时嘴型同步。
- 可选：粘贴 Meet 链接测试 mascot 入会。
7. 进阶：Ollama、低显存与集成
本地推理：ollama pull qwen2.5:7b 后在设置填 http://127.0.0.1:11434/v1。8 GB 内存仅云端 API 即可；16 GB Apple Silicon 可舒适跑 7B。Gmail/Slack/Notion 等走 OAuth；Memory Tree 可用 SFTP/rsync 备份到远程 Mac。
8. 常见报错速查表
| 报错 / 现象 | 原因 | 解决 |
|---|---|---|
| openhuman: command not found | PATH 未含 brew/npm 前缀 | brew link openhuman 或重开终端 |
| mascot 无响应 | LLM 未配置或 401 | 重跑 onboarding，检查 API Key 额度 |
| CUDA OOM | 本地模型过大 | 换 7B 量化或改云端 API |
| Memory Tree 为空 | subconscious 未启用或权限 | 检查磁盘权限与集成 OAuth 状态 |
| Linux 无法启动 WebView | 缺 GTK/WebKit | sudo apt install libwebkit2gtk-4.1-0 等依赖 |
9. 常见问题
Q：没有 GPU？ 可走云端 API；Mac M 系列无独显也能跑 Ollama 7B。
Q：如何更新？ brew upgrade openhuman 或应用内检查；升级前备份 Memory Tree。
Q：商用？ GPL3 copyleft，SaaS 再分发需法务评估。
10. 总结
按本文可在三平台完成 OpenHuman 安装与 Memory Tree/mascot 验证。笔记本合盖与 VPS 无 GUI 会打断 subconscious——这是运行环境约束，不是产品缺陷。
若要 7×24 复利本地记忆，SFTPMAC 远程 Mac mini M4 提供 SLA、SSH 即连与 Memory Tree 的 SFTP 备份，月租比自购更灵活。