桌面一键安装 · OAuth 集成 · 六步 Runbook · 本地/托管边界 · 7×24 宿主选型
想在 2026 年跑通 OpenHuman（tinyhumansai/openhuman，GitHub 约 2.9 万 Star）却搞不清「该 pip 装模型还是下 DMG」？本文按保姆级路径写清：Rust + Tauri 桌面端、Memory Tree 本地 SQLite、118+ OAuth 集成与每 20 分钟 auto-fetch。结构含环境对照表、六步 Runbook、首次请求验收、报错表与7×24 宿主建议（相对 OpenClaw 双框架文 专注 OpenHuman 单机安装）。
OpenHuman（TinyHumans，GPL-3.0）是本地优先的桌面 AI 超级助理：用 Memory Tree 把 Gmail、GitHub、Notion、Slack 等源数据规范成 Markdown 分块并写入本机 SQLite，而非黑盒向量库；内置自动模型路由（推理任务走前沿模型、轻量任务走低成本模型）、网页搜索、Coder 工具链、语音与可加入 Google Meet 的桌面吉祥物。与 ChatGPT 网页版差异在于：跨周上下文留在你的磁盘，且集成以 OAuth 一键完成。
安装期五大痛点：把 OpenHuman 当成「要配 CUDA 的数字人项目」、忽略本地 vs 托管边界、未等 auto-fetch 完成就提问、在合盖 MacBook 上期待 7×24 同步、以及从源码编译却缺 Node 24 / Rust 1.93。下文只解决官方桌面安装 + 首次跑通；若需与 OpenClaw 同机对比，见 5 月双框架文。
| 环境项 | 最低要求 | 推荐（大邮箱 + 本地模型） |
|---|---|---|
| 系统 | macOS / Windows 10+ / Linux 桌面 | macOS 14+ Apple Silicon 或 Ubuntu 24.04 LTS |
| 内存 | 4 GB+ | 16 GB+（官方文档：大邮箱/大仓库或本机模型） |
| 磁盘 | 约 2 GB 应用 + 增长型 SQLite | 50 GB+ SSD，留 Memory Tree 与日志 |
| GPU | 非必须（默认云端路由） | 本机 local model 时 Apple Silicon UMA 更稳 |
| 网络 | 登录与 OAuth 需外网 | 稳定链路，利于 Meet 与 auto-fetch |
误用 pip/CUDA 路线：OpenHuman 终端用户走安装包或 curl 脚本，不是 pip install -r requirements.txt 数字人仓库。
忽略数据边界：Memory Tree 在本地，但默认登录、部分 OAuth、搜索代理仍经托管服务——Advanced 可改 RPC 与自有模型。
首问太早：连接 Gmail/GitHub 后需等待约 20 分钟 级 auto-fetch 写入树，再问「总结我上周邮件」才靠谱。
本机当 7×24 服务器：笔记本合盖会断同步；Memory Tree 复利依赖常开桌面宿主。
源码编译缺依赖：贡献者需 Git、Node.js 24+、pnpm 10.10、Rust 1.93（含 rustfmt/clippy）、CMake 与子模块。
同一套 OpenHuman，换安装渠道与宿主后差异在签名更新、uptime 与是否适合后台 auto-fetch。下表面向「装完还要让 Memory Tree 每天涨」的生产体感。
| 渠道 / 宿主 | 适合谁 | 7×24 auto-fetch | 备注 |
|---|---|---|---|
| 官网 DMG / MSI | macOS / Windows 普通用户 | 依赖机器常开 | 从 tinyhumans.ai/openhuman 下载 |
| curl / Homebrew / apt | 熟悉终端的 macOS / Linux | 同上 | 脚本与包管理器与 README 同步 |
| 个人 MacBook | 试用、轻量集成 | 合盖即断 | 仅 POC，不建议生产记忆复利 |
| Mac Mini M4 月租 | 团队共享 Memory Tree、Meet 代理 | 机房 SLA 常开 | SSH 交付，适合与 Ollama/OpenClaw 同机（见 5 月文） |
安装只要几分钟；让 Memory Tree 每 20 分钟自动长大，才需要对的 7×24 宿主。
官方提供 macOS/Linux 一键脚本与 Windows PowerShell；Linux 还可配置 signed apt 源。若你计划在租赁节点上同时跑 OpenClaw Gateway 与 OpenHuman 桌面，优先选 16 GB+ UMA 的 M4，并给 SQLite 与日志单独留磁盘配额。
以下面向终端用户桌面安装（非源码贡献）。数据默认落在本机应用数据目录（含 SQLite Memory Tree 与 Markdown vault），升级前请备份。
下载并安装：打开 tinyhumans.ai/openhuman 取 DMG/MSI，或执行官方安装脚本（macOS/Linux x64）。
首次启动与登录：进入 Sign in! Let's Cook，用社交账号登录；多数用户无需改 Advanced RPC URL。
连接首个源：在引导页 OAuth 连接 Gmail 或 GitHub（118+ 集成任选），确认授权成功。
等待 auto-fetch：保持应用前台或常开宿主约 20 分钟，让核心调度拉取并折叠进 Memory Tree。
首次请求验收：提问如「总结我 GitHub 上周打开的 PR」或「按主题归纳近期邮件」，确认回答引用你的数据而非泛化闲聊。
可选进阶：在设置中查看模型路由、开启本地模型（大内存机器）、或配置自有 Composio / 搜索凭证以收紧托管依赖。
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash brew tap tinyhumansai/core brew install openhuman
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
本地 vs 托管：Memory Tree、Markdown vault、工作区配置在本机；默认仍使用 OpenHuman 托管的登录、模型路由、部分集成 OAuth 与搜索代理。要完全自有模型与凭证，请走文档中的 custom setup 路径。
下列症状多出现在「应用已打开但 Memory Tree 像空的」阶段——按表逐项排除，避免同时重装、换账号、清空数据库。
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 登录后无法连接 Gmail/GitHub | 网络或 OAuth 回调被拦 | 检查系统代理/防火墙；重试 OAuth；企业环境放行回调域名 |
| 回答与我的数据无关 | auto-fetch 未完成 | 常开应用等待约 20 分钟后再问；查看集成页是否 Active |
| Linux 安装脚本失败 | 非 x64 或缺依赖库 | 改用官网包；查阅 GitBook Getting Started 平台说明 |
| pnpm dev:app 编译失败 | Node/Rust 版本不符 | 对齐 Node 24+、pnpm 10.10、Rust 1.93 与子模块 |
| 本机模型 OOM | 内存不足 | 关闭 local model 回托管路由，或换 16 GB+ 宿主 |
大邮箱或单体仓库 ingest 时，优先保证磁盘 IO 与 16 GB RAM；低内存可暂时减少并发源。Voice、Meet 代理与 Coder 工具链默认已打包，无需再装「读文件插件」。与其他自动化栈（如 OpenClaw Gateway）同机时，为 SQLite 与日志目录做快照备份，避免并发清理误删 vault。
tinyhumansai/openhuman 约 2.9 万 Star（2026 年 6 月口径），Rust + Tauri 桌面栈。实战场景：独立开发者连接 GitHub + Notion，让助理自动生成周报；运营连接 Gmail + Calendar 做会议摘要；团队把 OpenHuman 装在租赁 Mac Mini 上，用 VNC/SSH 维护而笔记本可合盖。笔记本与家用 PC 能完成安装验收，却在合盖休眠与跨区 IO 上打断 Memory Tree 复利；纯 Linux VPS 无官方完整桌面体验。要把 OpenHuman 当「记得住你上周邮件的同事」，Mac Mini M4 月租把 uptime 与 UMA 打包成可预期 OpEx。
若你已完成本文 Runbook 并需要 7×24 常开节点，VpsMesh 提供 Mac Mini M4 云端租赁：SSH 交付、面板看资源、退租前可备份应用数据目录。套餐见 Mac Mini M4 租赁价格，部署问题见 帮助中心，在线下单见 订购页。
注意：勿在同一周末同时换宿主、清空 Memory Tree、升级大版本并改全部 OAuth——四项并行无法二分定位。先稳定首次请求 24h，再动本地模型或 Meet 代理。
不需要。终端用户通过官网安装包、curl | bash、Homebrew 或 apt 安装桌面应用即可。仅在你从源码编译时才需要 Node 24+、pnpm 10.10、Rust 1.93 等开发链，与「数字人 CUDA 训练」不是同一路线。
Memory Tree 数据库、Markdown vault 与工作区配置默认在本机 SQLite。默认设置仍使用 OpenHuman 托管登录、模型路由、部分 OAuth 与搜索代理；可在 Advanced / custom setup 中接入自有模型与 Composio 凭证以收紧边界。