若你在 2026 年搜尋「OpenHuman 安裝教學」，很容易撞上過時的 Python 複製 + 模型權重寫法——那套流程更像泛化的「數位人倉庫」範本，與 tinyhumans 目前主推的桌面 UI Agent 並非同一產品。本文面向要在 macOS / Windows / Linux 上把 OpenHuman 從「下載安裝」推進到「登入、連接 Gmail/Slack、等待首輪 ingest、Memory Tree 可用、可選 Ollama 本機推理」的初學者與開發者：先拆六大安裝誤判，再給環境對照表與簽名套件優先的安裝路徑，隨後給出八步首跑清單與報錯矩陣。若你同時關心與 OpenClaw 的組合部署，可對照站內 租用 Mac 跑 OpenClaw & OpenHuman。租用單價見 NOVAKVM 租用價格頁，下單見 雲端訂購頁。下文版本與指令以官方文件與 GitHub Releases 為準，發版後請重新開啟連結核對。
[ SECTION_01 ] // PAIN_MAP 裝 OpenHuman 時最常見的六大誤判（2026）
- 「必須先 git clone 再 pip install -r requirements.txt」：官方主路徑是桌面安裝套件或系統套件管理器（Homebrew / 簽名 APT / MSI），不是終端機裡手工拉 Python 依賴的數位人工程。
- 「沒有 NVIDIA GPU 就跑不起來」：OpenHuman 預設可走託管模型路由；本機敏感步驟可選用 Ollama，並非強制 CUDA 訓練環境。
- 「裝完立刻問 Briefing 為什麼很空」：官方 Getting Started 寫明，連接資料來源後首輪自動擷取約在二十分鐘內觸發，過早評判記憶品質會誤判為「壞了」。
- 「所有資料都在雲端」：Memory Tree 資料庫、Markdown vault、工作區設定在本機；登入、部分 OAuth 與模型路由仍可能走 OpenHuman 託管服務，需區分邊界。
- 「curl | bash 與 Homebrew 完全等價」：README 明確提示腳本來自
raw.githubusercontent.com、無獨立簽名校驗；正式環境應優先簽名原生套件。 - 「筆電合蓋也能當正式 ingest 機」：大信箱、大程式碼庫同步會吃記憶體與 SSD；睡眠會中斷背景擷取，與「能開啟 App」不是一回事。
下列為 OpenHuman 官方入口，請在發版後再次開啟核對安裝程式 URL 與系統需求。
OpenHuman 官方下載頁（tinyhumans.ai）
OpenHuman Getting Started（GitBook）
tinyhumansai/openhuman（GitHub 儲存庫與 Releases）
[ SECTION_02 ] // ENV_MATRIX OpenHuman 環境需求：最低設定與部署載體怎麼選
下表彙總桌面用戶端的務實下限；同機跑 Ollama 或大信箱 ingest 時請按「建議」欄規劃。金額與庫存不在此表，請開啟 租用價格頁 核對。
| 項目 | 最低 | 建議（大信箱 + 可選本機模型） |
|---|---|---|
| 作業系統 | macOS / Windows / Linux 桌面版（見官方下載頁） | macOS 14+（Apple Silicon）或 Ubuntu 24.04 LTS 桌面 |
| 記憶體 | 官方文件 cited 4 GB+ | 16 GB+；超大 Gmail/儲存庫同步或同機 Ollama 評估 24–32 GB |
| 磁碟 | 數 GB 可用空間 | 高速 SSD；vault + SQLite ingest 可隨信箱規模顯著成長 |
| 顯示卡 | 非必須（託管路由） | Apple Silicon 統一記憶體利於本機推理；無獨立顯卡亦可走 CPU/Ollama 路徑 |
| 網路 | 可存取登入與整合 OAuth | 穩定出口；首次 ingest 與背景約 20 分鐘週期擷取依賴持續連線 |
| 載體 | 安裝難度 | 背景 ingest | 典型問題 |
|---|---|---|---|
| 個人 MacBook | 低（Homebrew / DMG） | 合蓋即斷，適合體驗 | 私人郵件與 Agent 記憶同機 |
| 無桌面 Linux VPS | 高（非官方主路徑） | 缺原生 GUI 與官方桌面整合 | 螢幕智慧、語音等能力受限 |
| NOVAKVM 月租 Mac Mini M4 | 低（與 macOS 主路徑一致） | 獨占裸金屬 7×24 連線 | 需規劃 vault 備份與退租擦除 |
只想驗證 UI 與一條 Prompt？筆電足夠；要讓 Memory Tree 持續 ingest 數週，請把 App 放在不會睡眠的正式 Mac 伺服器上。
[ SECTION_03 ] // INSTALL OpenHuman 各平台安裝：簽名套件優先，腳本為備選
macOS（建議 Homebrew，走系統套件管理簽名鏈）：
brew tap tinyhumansai/core
brew install openhumanLinux（Debian/Ubuntu 簽名 APT 來源，架構以官方儲存庫為準）：需先匯入 GPG 與 sources.list.d 項目，再 apt-get install openhuman。完整指令序列見 GitHub README「Linux (Debian/Ubuntu — signed apt repo)」章節，發版後請重核 URL。
Windows：從 GitHub Releases 下載簽名 .msi 安裝；亦可在官方下載頁取得最新建置。
通用安裝程式：各平台亦可從 Releases 取得 .dmg、.deb、.AppImage 等。若必須使用腳本，官方提供 macOS/Linux 與 Windows 的 install 腳本，但 README 標註為未單獨簽名的 live 腳本，完整性風險高於原生套件。
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash安裝完成後開啟桌面 App 一次，確認 Dock/開始功能表出現 OpenHuman 圖示；不要在此階段跳過登入與資料來源連接。
[ SECTION_04 ] // RUNBOOK 八步跑通 OpenHuman：登入、連接來源、首條 Prompt 與本機 AI
- 下載並安裝：優先 Homebrew / APT / MSI；安裝後啟動 App，確認版本與 Releases 頁一致。
- 登入產品帳號：首屏為 Sign in；多數使用者走社交登入。Advanced 面板可填自訂 core RPC URL（自建後端情境），一般使用者可忽略。
- 理解本機與託管邊界：Memory Tree、vault、工作區在本機；預設仍用託管 sign-in、模型路由、整合 OAuth 與搜尋代理——自訂路徑見官方 Custom setup 文件。
- 連接至少一個資料來源：透過設定精靈 OAuth 接入 Gmail、Slack 等；授權失敗時檢查系統時間與瀏覽器回呼。
- 等待首輪 ingest：官方說明連接後約二十分鐘內觸發第一次自動擷取；此期間可瀏覽 UI，但 Briefing 類回答可能仍偏空。
- 傳送首條 Prompt 冒煙測試：ingest 後再試「總結我上週郵件主題」類問題，驗證 Memory Tree 是否已有上下文。
- 可選：開啟 Ollama 本機 AI：在設定中啟用本機執行階段（若版本提供）；同機跑模型時按 16 GB+ 規劃記憶體，並監控 SSD 佔用。
- 備份 vault 目錄：換機或退租前備份 SQLite Memory Tree 與 Obsidian 相容
.mdvault，避免只重裝 App 導致「失憶」。
Memory Tree 會把連接資料規範化為約 3k token 的 Markdown 區塊，寫入本機 SQLite，並同步到可編輯的 vault；這與「每次對話從零開始」的純雲端聊天產品路徑不同。若你需要在遠端 Mac 上長期跑 ingest，SSH 與連線基線見 雲端說明中心。
[ SECTION_05 ] // TROUBLESHOOT OpenHuman 安裝與首跑常見報錯怎麼排
| 現象 | 常見原因 | 處理方向 |
|---|---|---|
| 按 pip 教學裝完找不到 App | 誤用非官方「數位人」儲存庫範本 | 改用 tinyhumans 桌面安裝路徑與 Releases |
| 登入後一直無郵件上下文 | 未滿首輪 ingest 週期 | 等待約 20 分鐘後再測 Prompt |
| 磁碟快速成長 | 大信箱 + vault 雙寫 | 清理舊連接、換大 SSD 或遷到 512GB+ 租機 |
| Ollama 開啟後卡頓 | 記憶體與模型體量不匹配 | 換更小量化模型或升到 24–32 GB 記憶體檔 |
| brew install 失敗 | tap 未新增或架構不支援 | 核對 README 中 brew tap 與 Apple Silicon/Intel 套件名 |
進階：內容播報類實戰。在 ingest 完成後，可用「根據我上週某封郵件寫 30 秒口播稿」類 Prompt 驗證 Agent 是否讀懂 Memory Tree；匯出或二次剪輯可在 vault 中直接改 Markdown 區塊。即時 Meet 參與、吉祥物口型等能力以目前 Releases 說明為準，勿照搬未註明出處的示範效果。
[ SECTION_06 ] // HARD_FACTS 可引用技術資訊與 NOVAKVM 收束
- 授權與儲存庫：OpenHuman 在 GitHub 以 GNU GPL-3.0 發布，程式碼庫為
tinyhumansai/openhuman。（來源：儲存庫 LICENSE，發版後請重核。） - 系統需求：官方 Getting Started 寫明桌面支援 macOS、Windows、Linux，4 GB+ RAM，大信箱/大儲存庫或同機本機模型建議 16 GB+。
- 記憶架構：Memory Tree+ 將資料 canonicalize 為 ≤3k token Markdown 區塊，分層摘要存 SQLite，並落地 Obsidian 相容 vault。（來源：專案 README 功能說明。）
- 整合節奏：連接 Gmail 等後，首次自動擷取約在二十分鐘內觸發；後續背景節奏以 GitBook 為準。
- 版本核對：請以 GitHub Releases 與 App 內關於頁為準；勿照搬二手稿中的 Star 數或未測量的效能排名。
把「裝通」當成起點：個人筆電適合週末體驗，但睡眠、系統更新與私人郵件同碟會讓 Memory Tree ingest 頻繁中斷；無 GUI 的 Linux VPS 很難完整承載官方強調的桌面整合與螢幕上下文。若你已在本地驗證 OpenHuman 值得長期用，更務實的正式路徑是先按月租獨占 Mac Mini M4 伺服器 跑滿 2–4 週 ingest 與 vault 成長曲線，再決定是否自購硬體。
在 NOVAKVM 租用價格頁 按記憶體與磁碟選檔，從 雲端訂購頁 拉起節點，按本文八步完成安裝與首跑。對需要原生 macOS 安裝路徑、大信箱 ingest 7×24 連線與可預測退租擦除的 OpenHuman 正式環境而言，NOVAKVM Mac Mini 雲端裸金屬租用通常比讓主力筆電長期開機更低決策成本；頻寬與遠端存取細節可於 雲端說明中心查閱。