OpenHuman（TinyHumans AI 開源）是一款桌面優先的個人 AI Agent：把 Gmail、日曆、GitHub 等接入後，透過 Memory Tree 與 Obsidian 相容的 Markdown 庫把上下文留在本機 SQLite 裡，並可用 Ollama 做可選本地推理。許多人搜「OpenHuman 安裝」時會被過時的 Python 克隆教學帶偏——官方 2026 路徑其實是 Homebrew / apt / 簽名安裝包，而不是 pip install -r requirements.txt。
本文面向想在 macOS、Windows 或 Linux 上從零跑通 OpenHuman 的初學者與開發者：先拆解安裝痛點與宿主對照，再給原生套件安裝 → 首次啟動 → 帳號與整合 → Ollama → Memory Tree 驗收 → 7×24 宿主 六步清單。讀完應能獨立完成安裝驗收，並判斷該把資料目錄放在本機還是不休眠的 Mac Mini 上。
01 OpenHuman 安裝前必須知道的痛點：不是「git clone + pip」那條路
OpenHuman 基於 Rust + Tauri + React 打包為桌面應用（GPL-3.0，Early Beta）。與 OpenClaw（終端 Gateway + Node 生態）或 Hermes Agent（安裝器拉 Python/Node 到 ~/.hermes/）不同，終端使用者不需要自己編譯 Python 環境；從原始碼貢獻才需要 Node 24+、pnpm、Rust 等工具鏈。
- 教學過時：網上部分「數位人」文章仍寫
conda create、checkpoints/*.pth，那是另一類專案範本，與 tinyhumansai/openhuman 無關。 - 腳本安裝無簽名校驗：官方 README 明確警告
curl … | bash無法偵測腳本篡改，生產環境應優先 Homebrew bottle / 簽名 apt / MSI。 - 託管與本地並存：Memory Tree 與工作區在本地，但預設登入、模型路由、部分 OAuth 會走 OpenHuman 託管後端；完全離線需按文件切換 BYO 模型與 Composio 直連模式。
- 合蓋即斷：20 分鐘一輪的 auto-fetch 與背景記憶壓縮依賴主機清醒；筆電睡眠會導致上下文同步中斷。
- Linux Wayland：AppImage 在部分 Wayland 環境可能啟動失敗，Debian/Ubuntu 使用者應優先 .deb / apt 路徑（官方 issue #2463）。
結論先行：安裝可在十幾分鐘內完成；長期體驗取決於宿主是否 7×24 線上，以及本地 vault 與 SQLite 是否可備份、可遷移。
若你過去用過 OpenClaw 或 Hermes，請特別注意：OpenHuman 不是 CLI Gateway，而是帶 GUI 的桌面 Agent。一般使用者只需下載安裝包、完成 onboarding，不必手動配置 Node 版本或 launchd plist。開發者若要從原始碼建置，才需準備 Rust toolchain 與 pnpm workspace。
安裝命令與行為以 TinyHumans 官方文件為準；發版後請再次開啟下列連結核對。版本號以 GitHub Releases 頁 tag 為準，勿沿用社群複製的過期 gist。
02 OpenHuman 環境要求與部署宿主對照：裝在哪台機器最省心
官方提供 macOS（Intel / Apple Silicon）、Windows 10/11、Linux（Debian/Ubuntu amd64、Arch AUR） 安裝包。下表用於選型，具體磁碟與記憶體請以你選擇的 Ollama 模型尺寸為準。
| 宿主 | 7×24 可用性 | 安裝摩擦 | Memory Tree / Ollama | 典型短板 |
|---|---|---|---|---|
| MacBook 本機 | 合蓋/睡眠易斷 | 低（Homebrew / .dmg） | Apple Silicon + Ollama 體驗好 | auto-fetch 中斷、系統更新重啟 |
| Windows 桌上型電腦 | 可常開但更新重啟多 | 低（簽名 MSI） | NVIDIA 可選本地模型 | 與 macOS 工具鏈不一致 |
| Linux 桌面 / 無頭 | 伺服器級線上率高 | 中（apt 優於 AppImage） | Ollama 官方支援 Linux | 無 GUI 時需確認發行版支援 |
| Mac Mini M4 月租裸金屬 | 機房 SLA，目標長期線上 | 低（SSH + brew） | 統一記憶體適合 7B–14B 級本地模型 | 需選可信機房與租期 |
資源參考（結合 Ollama 本地路徑）：僅託管模型 + 輕量整合時 8 GB 記憶體 可試玩；若常駐 Qwen2.5 / Gemma3 7B 級模型並開瀏覽器類工具，建議 16 GB 及以上統一記憶體或 RAM。本地資料目錄（Memory Tree、vault、SQLite）請預留 10–30 GB SSD，視信箱與倉庫同步量成長。
選宿主時還要考慮網路穩定性：OAuth 回呼、auto-fetch 與模型下載都依賴可達的 HTTPS 出口。跨境 VPS 延遲高時，Memory Tree 更新會變慢；本機筆電若常換 Wi‑Fi，授權 token 可能需重新登入。機房內 Mac Mini 通常有固定公網或 Tailscale 通道，更適合長期當「記憶複利」宿主。
若團隊多人共用同一台 Mac Mini，建議每位使用者各自帳號與獨立工作區目錄，避免 SQLite 鎖衝突；CALMVPS 裸金屬交付為單租戶獨占，天然符合此隔離模型。
03 OpenHuman 官方安裝路徑：Homebrew、apt 與 Release 怎麼選
推薦順序：官網或 GitHub Releases 下載對應平台安裝包 → 或使用系統套件管理器（帶簽名鏈）。僅在無法使用套件管理器時再考慮腳本安裝。
macOS（Homebrew，官方推薦）：
brew tap tinyhumansai/core
brew install openhuman
openhuman --versionDebian / Ubuntu（簽名 apt 源）：
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] https://tinyhumansai.github.io/openhuman/apt stable main" | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update && sudo apt-get install -y openhumanWindows：從 GitHub Releases 下載簽名 .msi 並安裝。
備選（無完整性校驗，慎用）：官方 README 提供的腳本安裝；發版後請核對倉庫是否已發布 GPG 驗證流程（issue #2620）。
安裝完成後，不論平台都應執行一次版本檢查：openhuman --version（若 CLI 已入 PATH）。macOS 使用者也可在「應用程式 → OpenHuman → 關於」核對 build 號。Linux 伺服器若僅跑 Ollama 而 OpenHuman 在另一台桌面機，請確認兩端模型名稱與 API 端點一致，避免路由到不存在的本地服務。
04 六步落地：首次啟動、整合、Ollama 與 Memory Tree 驗收
- 完成安裝並啟動應用：從 Launchpad 或應用程式選單開啟 OpenHuman；若 CLI 已入 PATH，可執行
openhuman --version核對版本（請以 Releases 頁目前 tag 為準）。 - 完成引導與帳號：按 UI 完成 onboarding；若使用預設託管體驗，需登入 OpenHuman 帳號以啟用模型路由與部分 OAuth；純本地實驗可在設定中切換 BYO / Ollama（見官方 Local AI 文件）。
- 安裝並啟動 Ollama（可選本地推理）：在 macOS / Linux 安裝 Ollama，拉取文件推薦的模型（如 Qwen2.5、Gemma3 等，以 gitbook 為準），在 OpenHuman 模型路由中選擇本地端點。
- 連接 1–2 個資料源做冒煙測試：優先連接 GitHub 或日曆等低敏整合，等待約 20 分鐘 auto-fetch 週期，觀察 Memory Tree 是否出現新 Markdown 分塊。
- 驗收 Memory Tree 與 vault：在應用內開啟 Memory Tree / Obsidian 相容目錄，確認 SQLite 與
.md檔案同步成長；若為空，檢查整合授權與網路，而非盲目重裝。 - 規劃 7×24 宿主：需要全天候 auto-fetch 與訊息通道時，將執行個體遷移到停用睡眠的 Mac Mini（本地或 CALMVPS 裸金屬），打包備份整個工作區與設定目錄後再切換機器。
六步中第 4、5 步最容易被跳過：許多使用者連完 GitHub 就立刻問「為什麼 Memory Tree 是空的」。官方 auto-fetch 週期約 20 分鐘，不是即時 webhook；請給系統一個完整週期再判斷。若 vault 目錄權限被 macOS 隱私設定阻擋，應在「系統設定 → 隱私權與安全性」授予 OpenHuman 所需磁碟存取。
Ollama 端建議先在本機終端驗證：curl http://127.0.0.1:11434/api/tags 能列出已 pull 的模型後，再在 OpenHuman 設定裡選本地路由。Apple Silicon 請確認 Ollama 為 arm64 版本，避免 Rosetta 下推理速度驟降。
若計畫在 CALMVPS 裸金屬 Mac 上部署：先在 定價頁 選定 M4 記憶體與區域，SSH 登入後執行與本地相同的 brew install openhuman；退租前打包備份 OpenHuman 本地資料目錄（含 Memory Tree / vault）。下單與交付見 雲端訂購頁。
05 可引用參數、常見報錯與 CALMVPS 場景收束
- 技術棧：Rust + Tauri v2 + React 桌面殼；Memory Tree 使用本機 SQLite，分塊約 ≤3k token 寫入 Markdown（來源：官方 README / gitbook）。
- 同步節奏：活躍整合預設約 20 分鐘 一輪 auto-fetch 拉取上下文（以文件為準，非即時推送）。
- TokenJuice：工具輸出與網頁抓取在進模型前壓縮，官方宣稱最高約 80% token 節省（實際取決於任務類型，請自行觀測帳單）。
| 現象 | 常見原因 | 處理 |
|---|---|---|
| 按 pip/conda 教學裝失敗 | 誤用其它專案文件 | 改用 Homebrew / apt / Release 安裝包 |
| Linux AppImage 閃退 | Wayland / sharun 相容 | 改用 .deb 或文件中的環境變數變通 |
| Ollama 無回應 | 服務未啟動或模型未 pull | ollama serve + ollama pull <model> |
| Memory Tree 一直為空 | 整合未授權或未到 fetch 週期 | 檢查 OAuth 與等待 20 分鐘週期 |
FAQ 速答：沒有獨顯也可執行——託管模型路徑不強制 GPU；本地 Ollama 在 Apple Silicon 上通常比純 CPU Windows 更順暢。Mac M 系列請優先 arm64 安裝包與 arm64 Ollama 模型。模型下載慢可換鏡像網路或在機房側 Mac 上預先 ollama pull。
升級 OpenHuman 時，優先使用與初次安裝相同的通道（Homebrew brew upgrade openhuman、apt apt upgrade 或 Windows MSI 覆蓋安裝）。跨大版本前請先備份 vault 與 SQLite；Beta 期功能開關可能變動，預設路由策略以新版 gitbook 為準。
安全方面：OpenHuman 會存取郵件、日曆等敏感整合，宿主應啟用磁碟加密、定期快照，並限制 SSH 僅來自信任 IP 或 Tailscale。勿在共用 VPS 上混跑不可信 Skill 與 OpenHuman 同一使用者帳號。
把 OpenHuman 裝在經常合蓋的筆電上，短板是 auto-fetch 連續性與 Memory Tree 複利；裝在廉價跨境 VPS上，短板是缺少官方桌面體驗與 GUI 維護成本；只裝不備份，短板是換機即丟上下文。對需要手把手原生安裝路徑、Ollama 本地推理、20 分鐘記憶同步、且要快速升配統一記憶體的生產環境，CALMVPS 裸金屬 Mac Mini M4 月租 通常是更優解：SSH 交付即用，獨占 Apple Silicon，按月彈性下單。機型與租期見 CALMVPS 定價頁，立即下單見 雲端訂購。