裝 OpenHuman 最怕教程只寫「下一步」——一卡住就不知道問題在下載、登入、模型還是記憶。本文按正常安裝配置流程走完全程，每個階段標明成功標誌與卡住先查；目標不是排錯大全，而是讓你從 0 真正跑通。
〇 總覽：從 0 到跑通的七個階段
卡住時先判斷落在哪一段：下載 → 安裝 → 登入 → 模型 → 整合 → 記憶 → 首次輸出。下表是全文導航，後文逐段展開。
| 階段 | 成功標誌 | 常見卡點 | 下一步 |
|---|---|---|---|
| 準備 | 能訪問官網、記憶體達標 | 網路/DNS、RAM 不足 | 換網路或升級記憶體後再裝 |
| 下載安裝 | App 能啟動、版本與官網一致 | 裝錯項目、架構不匹配 | 核對域名與 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 無痕視窗；登入成功但白屏 → 完全退出 App 再開，並查看 App 內日誌/診斷（具體入口以當前版本 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 記憶工作流。