OpenHuman 桌面 AI 助手與 Memory Tree 本地記憶架構示意

2026 OpenHuman 保姆級安裝與配置全指南：macOS / Windows / Linux 從零到跑通只看這一篇

OpenHuman（tinyhumansai/openhuman）是 2026 走紅的 GPL3 桌面 Agent：Rust + Tauri、Memory Tree、mascot 數位人、Google Meet。本文給一步都不跳的環境矩陣、三平台安裝、驗證、Ollama 與報錯表，約 20 分鐘。

1. 為什麼選 OpenHuman、本教程能幫你實現什麼

OpenHuman 是 GPL3 桌面 Agent（Rust + Tauri）：Memory Tree、mascot、可選 Meet。與 OpenClaw、Hermes 不同，UI 優先。涵蓋：官方套件 → LLM → Memory Tree/mascot → Ollama。同機 OpenClaw 見《租 Mac 跑雙 Agent》。

2. 安裝前三類隱性痛點

  1. 誤走原始碼編譯：不需 git clone+Rust；優先 Homebrew/apt/MSI。
  2. LLM 未配卻測功能：跳過 API Key 會「介面能開、數位人無聲」。
  3. 筆電合蓋中斷 subconscious：7×24 節點 Memory Tree 複利更快。

3. 環境要求與硬體決策矩陣

配置項 最低要求 推薦配置
作業系統 macOS 12+、Win10 64 位、Ubuntu 20.04+ macOS 14+（Apple Silicon）、Win11、Ubuntu 24.04 LTS
CPU / 晶片 x64 四核 Apple M4 / M4 Pro；或 8 核 x64 + 獨顯 8 GB
記憶體 8 GB（僅雲端 API） 16 GB（Ollama 7B）；32 GB（多整合 + 本地 13B）
硬碟 10 GB 可用 50 GB SSD（含 Ollama 模型快取）
網路 / 頻寬 可存取 LLM API / OAuth 穩定低延遲；Meet 代理需可存取 Google

Apple Silicon 統一記憶體利於 Ollama 與 Agent 共存；NVIDIA 需 CUDA 12+ 與 VRAM，否則用雲端 API。

4. 安裝前準備與路徑選型

安裝路徑 適用平台 完整性校驗 推薦場景
Homebrew tap macOS、Linux brew 簽名鏈 日常使用者首選
signed apt Debian / Ubuntu amd64 GPG 倉庫 Linux 桌面 / 伺服器
官方 MSI / DMG Windows / macOS 發布頁簽名 無套件管理器環境
curl install.sh macOS / Linux x64 無（不建議正式環境） 快速試用
原始碼編譯 全平台 自驗 貢獻者 / 定制 CEF

前置：macOS 需 Xcode CLT；Linux 由 apt 自動拉 WebKit/GTK；Windows 直接裝 MSI，無需 Python。

5. 核心安裝步驟（macOS / Linux / Windows）

macOS（推薦 Homebrew）：

brew tap tinyhumansai/core && brew install openhuman

Linux：添加 signed apt 源後 sudo apt install openhuman；Arch 用 AUR openhuman-bin；其他發行版可用 Releases 的 AppImage。

Windows：從 GitHub Releases 安裝 signed .msi。快速試用可用 curl | bash 腳本，但正式環境優先 brew/apt/MSI 簽名鏈。

npm（跨平台）：npm install -g openhuman，需 Node ≥ 18，會校驗 SHA-256 後釋放原生二進位。

6. 首次執行與驗證清單

  1. 啟動應用並完成 onboarding（API Key 或 OAuth）。
  2. 冒煙對話，確認 LLM 有回覆。
  3. 檢查 Memory Tree 目錄是否產生 Markdown。
  4. 觀察 mascot busy/thinking 動畫；開 TTS 時嘴型同步。
  5. 可選：貼上 Meet 連結測試 mascot 入會。

7. 進階：Ollama、低顯存與整合

本地推理：ollama pull qwen2.5:7b 後填 http://127.0.0.1:11434/v1。8 GB 記憶體走雲端 API；16 GB Apple Silicon 跑 7B。Gmail 等 OAuth；Memory Tree 可 SFTP/rsync 備份。

8. 常見報錯速查表

報錯 / 現象 原因 解決
openhuman: command not found PATH 未含 brew/npm 前綴 brew link openhuman 或重開終端機
mascot 無回應 LLM 未配置或 401 重跑 onboarding，檢查 API Key 額度
CUDA OOM 本地模型過大 換 7B 量化或改雲端 API
Memory Tree 為空 subconscious 未啟用或權限 檢查硬碟權限與整合 OAuth 狀態
Linux 無法啟動 WebView 缺 GTK/WebKit sudo apt install libwebkit2gtk-4.1-0 等依賴

9. 常見問題

Q：沒有 GPU？ 可走雲端 API；Mac M 系列無獨顯也能跑 Ollama 7B。

Q：如何更新？ brew upgrade openhuman 或應用內檢查；升級前備份 Memory Tree。

Q：商用？ GPL3 copyleft，SaaS 再分發需法務評估。

10. 總結：裝通 OpenHuman 只是起點，7×24 才能讓 Memory Tree 複利

按本文可在 macOS/Windows/Linux 完成安裝、LLM、mascot 與 Memory Tree 驗證。合蓋、休眠、無 GUI VPS 是執行環境約束。

若你要數位人 Agent 持續累積本地記憶、並保留 Apple 生態與 GUI 完整性，SFTPMAC 遠端 Mac mini M4 租賃 提供機房 SLA、SSH 即連與 Memory Tree 目錄的 SFTP/rsync 備份——把「裝上了」變成「一直跑著」，比自購硬體更靈活的月租方案。