桌面一鍵安裝 · 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 憑證以收緊邊界。