装 OpenHuman 最怕教程只写「下一步」——一卡住就不知道问题在下载、登录、模型还是记忆。本文按正常安装配置流程走完全程，每个阶段标明成功标志与卡住先查；目标不是排错大全，而是让你从 0 真正跑通。
〇 总览：从 0 到跑通的七个阶段
卡住时先判断落在哪一段：下载 → 安装 → 登录 → 模型 → 集成 → 记忆 → 首次输出。下表是全文导航，后文逐段展开。
| 阶段 | 成功标志 | 常见卡点 | 下一步 |
|---|---|---|---|
| 准备 | 能访问官网、内存达标 | 网络/DNS、RAM 不足 | 换网络或升级内存后再装 |
| 下载安装 | 应用能启动、版本与官网一致 | 装错项目、架构不匹配 | 核对域名与 Release |
| 登录 | 进入主界面 | OAuth 跳转失败 | 换浏览器、关拦截插件 |
| 模型 | 发「你好」有回复 | BYOK/本地模型无响应 | 先走默认路由再开本地 |
| 集成 | 数据源显示已连接 | OAuth 过期、范围太窄 | 重授权并核对同步范围 |
| 记忆 | Memory 有条目 | 空树、等待不足 20 分钟 | 等首轮 auto-fetch |
| 实战 | 摘要/待办与资料一致 | 无上下文、答非所问 | 拆成「模型 vs 记忆」 |
一 安装前准备：系统、网络、账号与测试资料
根据 官方 Getting Started，OpenHuman 支持 macOS / Windows / Linux 桌面端，建议 4 GB+ 内存；若要 ingest 超大邮箱/仓库或同机跑本地模型，建议 16 GB+。
- 网络 — 能打开 tinyhumans.ai/openhuman 与 GitBook 文档；默认方案仍会走托管登录与模型路由（非完全离线）。
- 账号 — 准备用于登录的 Google/GitHub 等；第三方集成需单独 OAuth 授权，登录不等于已接入 Gmail。
- 测试资料 — 先用低敏邮箱或小号 GitHub，便于验证记忆是否写入；勿第一天接入生产邮箱全集。
- 可选本地模型 — 若计划 Ollama，先在本机单独跑通
ollama run，再进 OpenHuman 开 Local AI。
二 下载来源：如何避免装错项目或版本
成功标志：安装包来自 tinyhumans.ai/openhuman 或官方列出的包管理器；关于页版本号与 GitHub Releases 最新版一致。
推荐路径（按官方文档，任选其一）：
- 官网安装包 — macOS DMG、Windows MSI/EXE、Linux AppImage 或 .deb（最直观，适合新手）。
- Homebrew —
brew install tinyhumansai/openhuman/openhuman - 脚本安装 — macOS/Linux：
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash；Windows PowerShell 见 README。
tinyhumansai/openhuman、或第三方「破解整合包」。不确定时只从官网与 GitHub 官方组织下载。三 平台安装：Mac、Windows、Linux 验收点
| 平台 | 通过标准 | 卡住先查 |
|---|---|---|
| macOS | DMG 拖入应用程序后能打开；Gatekeeper 提示时选「打开」 | 安全设置拦截 → 系统设置 → 隐私与安全性 |
| Windows | MSI/EXE 安装完成，开始菜单有 OpenHuman | SmartScreen → 确认发布者；缺 VC++ 运行库 |
| Linux | AppImage 可执行或 apt 安装成功 | amd64/arm64 架构是否与机器一致 |
首次启动后 macOS 可能弹出辅助功能、输入监控等权限（语音热键需要）——可在 Settings → Automation & Channels 中复查；与首次跑通无关的权限可先拒绝。
四 首次启动：登录、工作区与打不开
首屏为 「Sign in! Let's Cook」，可用社交账号登录；Advanced 里的自定义 core RPC URL 多数用户可忽略。
成功标志：进入主界面，能看到对话与 Settings。卡住先查：浏览器 OAuth 被插件拦截 → 换 Safari/Edge 无痕窗口；登录成功但白屏 → 完全退出应用再开，并查看应用内日志/诊断（具体入口以当前版本 Settings 为准）。
五 模型配置：默认路由、BYOK 与本地无响应
OpenHuman 会为任务自动选模型（Automatic Model Routing）。新手建议：先确认云端路由能回复，再开 Local AI。
成功标志：对话里发「你好」或「用一句话介绍你自己」有正常回复。卡住先查：
- 完全无响应 — 网络/代理；是否仍在 Early Beta 维护窗口（查 Discord/GitHub Issue）。
- BYOK 失败 — Key 是否完整、provider 是否与设置一致、账户余额。
- Ollama / LM Studio 无响应 — 先在终端确认本地服务可达；再在 Settings 开启 Local AI 并确认
local_ai.runtime_enabled等项（详见 GitBook Configuration）。
六 集成授权：OAuth、同步范围与刷新
在 Settings 连接 Gmail、GitHub、日历等。成功标志：集成列表显示已连接，且无持续报错。
卡住先查：显示已连接但无数据 → OAuth 范围是否包含读取权限；企业 Google 是否需管理员审批；刷新不动 → 等待约 20 分钟 的首轮 auto-fetch（官方文档周期），不要几分钟内反复重装。
七 记忆同步：空上下文与验证方法
记忆落在本机 Memory Tree（SQLite + Markdown，可在 Memory 页 View vault in Obsidian 打开 /wiki/）。
成功标志：连接 Gmail 等后，约 20 分钟内 Memory 出现新条目；提问「过去 12 小时我需要知道什么？」能引用真实邮件主题。
卡住先查：一直空 → 集成是否真的 OAuth 成功、是否只连了无邮件的测试号、是否未满首轮周期；摘要离谱 → 在 Obsidian 里抽查原始条目是否准确，区分「模型胡编」与「源数据就没进来」。
八 首次实战：用一条任务同时验收配置
建议测试提示（官方示例风格）：「Summarize what I missed today.」 或中文：「根据我已连接的数据源，列出今天待办前三项。」
跑通标准：① 模型有回复；② 回复中的事实能在 Memory/Obsidian 中找到依据；③ 换一道更具体的问题（如某项目名称）仍能命中。若只有 ② 失败 → 查记忆；只有 ① 失败 → 查模型；都失败 → 回到登录与网络。
九 收尾：何时重装、如何保留配置
先查文档/Issue，再重装：单点 OAuth、个别集成、本地 Ollama 问题，通常不必重装整个应用。适合重装的情况：安装包损坏、版本跨度大需干净升级、或官方 Release notes 明确要求。
保留配置：Memory Tree 与 Markdown vault 在本机——重装前在 Memory 页确认 vault 路径并备份该目录（勿删未知文件夹）。卸载参考官方：Homebrew 用 brew uninstall openhuman；apt 用包管理器 remove；curl 手动安装见 GitHub docs/install.md。
仍无法解决 → GitHub Issues、Release notes 或 Discord（discord.tinyhumans.ai），附上版本号与复现步骤。
勾选以下各项，即表示 OpenHuman 已在你的机器上可工作、可排错：
- 1官方渠道安装，版本与 Release 一致
- 2登录成功，主界面可对话
- 3默认模型路由能回复「你好」
- 4至少 1 个低敏集成 OAuth 成功
- 5Memory 有条目，Obsidian 可打开 vault
- 6首次摘要/待办任务与资料一致
- 7知道卡住时对应哪一阶段、去哪查官方文档
十 在 Mac mini 上跑 OpenHuman 更稳
OpenHuman 需要后台 auto-fetch、SQLite 写入，还可选 Ollama 本地推理——Mac mini M4 统一内存适合中小模型，待机约 4W 级可 7×24 静默运行；macOS 下 Homebrew 安装、权限弹窗与 Obsidian 协作都更顺；把个人 Memory Tree 放在专用 mini 上，也与主力机办公数据隔离。若你正规划第一台个人 Agent 实验机，Mac mini M4 是性价比清晰的起点——先按本文跑通，再迁到长期在线的 Mac mini 节点。
OpenHuman 24/7 · 本地记忆获取 Mac mini，搭建你的 OpenHuman 节点
低功耗常驻 · 统一内存适合 Ollama · 与主力 Mac 隔离，安心试个人 AI 记忆工作流。