2026 OpenHuman 完整安裝配置指南：Homebrew / apt 到 Memory Tree 首跑，租 Mac 7×24 常駐

OpenHuman 由 TinyHumans AI 維護，GPL-3.0 授權，文件站 tinyhumans.gitbook.io/openhuman。與終端機優先的 Agent 不同，它設計為桌面 GUI 常駐應用：首次設定走圖形精靈，連接 SaaS 帳號後背景同步寫入 Memory Tree，對話時再壓縮檢索相關區塊注入 LLM。截至 2026 年 6 月，主線活躍版本為 v0.53.x，官方推薦透過 OS 套件管理器（Homebrew / apt）安裝以走完整簽章鏈，而非僅下載未簽章二進位。

安裝成功的判準不是桌面圖示能開啟——而是：帳號登入完成、至少一個資料源（本文以 Gmail 為例）同步寫入 Memory Tree、設定中可看到 SQLite 與 Obsidian 知識庫路徑有新增檔案，且可選的 Ollama 本地推理 在 config.toml 啟用後能回應首輪提示。若你關心為何 Memory Tree 必須落在持久主機，請先讀 OpenClaw 與 OpenHuman 雙框架文；本文專注「把 OpenHuman 裝起來並完成 Memory Tree 首跑」。

架構方面：OpenHuman 預設託管體驗仍使用 TinyHumans 後端做帳號登入、模型路由與 Composio OAuth；Memory Tree、Obsidian 知識庫與工作區設定 一律落在本機。可選「自備模型 / 自備 Composio」路徑，但部分即時觸發仍依賴託管後端——生產最小集通常是「GUI 常駐 + Gmail/Slack 連接 + 本地 SQLite 目錄可備份」。

社群 Issue 裡最高頻的失敗模式並非安裝包損壞，而是安裝渠道混用與主機輪廓不匹配。下表彙總安裝階段常見卡點——對照後可少花一半除錯時間。

• 渠道不一致：官網 DMG 與 Homebrew 版本並存時，openhuman CLI 路徑與設定目錄可能指向不同使用者資料夾；升級前應確認僅保留一條安裝路徑。
• Linux 無完整 GUI 堆疊：純 SSH 的 Linux VPS 可 apt 安裝二進位，但 Tauri 桌面首次 Onboarding 仍需本機顯示器或 VNC；與 雲端 Mac 部署文 中「OpenHuman 需 macOS 桌面」結論一致。
• OAuth 與同步等待：連接 Gmail 後需等待約 20 分鐘 排程同步，使用者以為「壞了」而反覆重裝，實際是首輪 ingest 尚未完成。
• 磁碟與權限：在 Docker 無持久卷或試點期頻繁還原快照的雲端機上，Memory Tree SQLite 與 Obsidian .md 每次重啟歸零，與 Hermes 安裝文 中「state.db 遺失」現象同構。
• 與 OpenClaw / Hermes 並行：若團隊已在跑 OpenClaw 訊息渠道 或 Hermes Telegram 閘道器，OpenHuman 更偏「桌面記憶與 SaaS 整合」；三者可同機但應分使用者與 Ollama 模型標籤，避免 11434 端口與記憶體爭用。

結論很直白：安裝 Runbook 必須包含主機選型。MacBook 適合開發除錯；Memory Tree 長期累積應落在始終在線、磁碟可稽核的節點上——這也是下文推薦 NUKCLOUD Mac Mini M4 雲端租賃 的原因。

OpenHuman 提供多條官方安裝路徑，優先順序建議：Homebrew tap（macOS / Linux）→ Debian/Ubuntu apt 簽章儲存庫 → curl 一鍵腳本 → 官網 / GitHub Releases 安裝包。前兩者走 OS 套件管理器簽章鏈，最適合生產環境 pin 版本。

macOS — Homebrew（推薦）：

brew tap tinyhumansai/core
brew install openhuman
openhuman --version

Linux — Debian / 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 openhuman

通用 — curl 一鍵腳本（與 雙框架文 相同入口）：

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

下列步驟在 macOS 14+、Ubuntu 22.04+ 桌面 與 NUKCLOUD 雲端 Mac 上均已驗證；雲端 Mac 需 VNC 或螢幕共享完成 GUI 步驟。

1. 01
   準備主機與 SSH：若走雲端 Mac，先在 下單頁 選定 16GB+ 實例並在 控制台 取得 SSH 與 VNC；凍結 macOS 小版本，建立專用 Unix 使用者（如 openhuman），預留 Fast SSD 給 Memory Tree 與 Obsidian 知識庫成長。
2. 02
   選渠道並安裝：macOS 優先 brew tap tinyhumansai/core && brew install openhuman；Linux 桌面走 apt 儲存庫；快速試點可用 curl 腳本。完成後執行 openhuman --version 確認 v0.53.x。
3. 03
   首次啟動與帳號登入：從 Launchpad 或 openhuman 啟動 GUI，依精靈登入 TinyHumans 帳號（或設定自備模型路由）。確認工作區目錄可寫——預設在使用者 Home 下的 OpenHuman 資料夾，勿指向 /tmp。
4. 04
   連接資料源：在設定中授權 Gmail、Slack、GitHub 或 Notion 等 OAuth 連接器；完成後等待首輪排程同步（約 20 分鐘）。可在 Memory Tree 檢視面板觀察 SQLite ingest 進度與 Markdown 區塊數量。
5. 05
   Memory Tree 與 Obsidian 知識庫：確認本機已生成階層式摘要樹與 .md 檔案；可選用 Obsidian 開啟同一 vault 做人工編輯，下次 ingest 會合併變更。大型信箱同步建議預留 數 GB 磁碟。
6. 06
   Pin 版本並備份：記錄目前 brew/apt 版本號；對 Memory Tree 目錄與 config.toml 做首次 tarball 備份。生產環境禁止試點期頻繁還原無備份快照。

OpenHuman 預設關閉本地 AI，需在使用者設定目錄的 config.toml 中明確啟用（路徑以安裝精靈為準）。若已按 OpenClaw 文 安裝 Ollama，可直接指向 127.0.0.1:11434：

local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true

在 GUI 設定中選擇 Ollama 端點，模型路由可分流：摘要與格式化走 7B/8B（如 Qwen2.5），複雜推理走雲端 API 或 13B 本地模型。切換模型不會自動遷移 Memory Tree——大改路由前請備份 SQLite 與 Obsidian 目錄。

Memory Tree 運作要點：連接器拉取的 HTML / JSON 會先正規化為 Markdown、壓縮冗餘格式，再以 ≤3k token 區塊評分並折疊進階層摘要樹；同一內容同步寫入 Obsidian 相容 vault。對話時 Agent 只檢索相關區塊注入 LLM，而非整庫塞進 context——這也是 16GB 雲端 Mac 上仍能跑大型信箱索引的原因。

• 儲存庫熱度：GitHub Star 約 1.2 萬（2026 年 6 月，以頁面即時數為準），GPL-3.0，TinyHumans AI 主導。
• 技術堆疊：Tauri v2 桌面殼、React 19 前端、Rust 核心、TypeScript Skills 層。
• 連接器廣度：118+ OAuth 整合（Gmail、Slack、Notion、Jira、Calendar 等），Composio 連接層。
• 基線硬體：官方建議 4GB+ RAM；信箱級同步 + 本地 13B 建議 16GB+ 統一記憶體。

OpenHuman 的 Memory Tree 會隨使用單調成長：試點一週後刪除磁碟等於把「已變聰明的助理」格式化。筆電闔蓋休眠會中斷背景同步；純 Linux VPS 又難完成 Tauri 首次 GUI。NUKCLOUD 雲端 Mac Mini M4 提供與自購相同的 macOS + Homebrew 路徑，並可透過 VNC 遠端完成 Onboarding，之後以登入項目或使用者會話保持 GUI 常駐。

1. 01
   在 定價頁 選 16GB/24GB 檔位，經 下單頁 開實例；控制台取得 SSH 與 VNC 連線資訊。
2. 02
   SSH 登入後 brew tap tinyhumansai/core && brew install openhuman；可選先 brew install ollama 並 ollama pull qwen2.5:7b。
3. 03
   VNC 登入桌面，啟動 OpenHuman，完成帳號登入與 Gmail OAuth；勿在同步完成前關閉 VNC 會話。
4. 04
   啟用 config.toml 本地 AI，指向本機 Ollama；發起首輪提示驗證 Memory Tree 檢索是否正常引用近期郵件摘要。
5. 05
   設定系統「登入時開啟 OpenHuman」或保持 VNC 使用者會話；監控 ~/Library/Logs 與 Memory Tree 目錄磁碟成長。
6. 06
   連續 72 小時觀測背景同步與 Ollama 記憶體壓力；穩定後再接入更多 OAuth 來源或與 OpenClaw 渠道 共用同一 Ollama 實例（注意模型標籤分流）。

同一套 OpenHuman 在不同主機上的維運摩擦差異巨大。下表協助你在「先裝在哪」階段就做對選擇。

安裝與 Memory Tree 階段的常見報錯可按下表快速定位：

需要桌面 Memory Tree + 可選本地 Metal 推理同機時，Linux VPS 無法替代 macOS 完整體驗；需要 Gmail 背景同步 7×24 且不想賭家庭寬頻時，筆電休眠會讓剛累積的記憶中斷 ingest。對要可稽核磁碟、VNC Onboarding、還能在 Agent 空閒視窗跑 Xcode CI 的團隊，NUKCLOUD 多區域雲端 Mac Mini M4 通常是比「本機 + 廉價 VPS」更穩的生產平面——可從 定價頁 按小時 pilot 再決定是否自購 Mini。