2026 OpenHuman 保姆級安裝教學：macOS / Windows / Linux 簽名安裝、Ollama 本地推論與 Memory Tree 排錯

約 18 分鐘閱讀 · MACCOME

適合誰：2026 年 5 月看到 TinyHumans OpenHuman 衝上 GitHub 熱榜，卻分不清「該用 brew 還是 curl|bash」「Ollama 怎麼接」「Memory Tree 有沒有寫入」，要在 macOS、Windows 或 Linux 上當天跑通桌面 Agent 的開發者與進階使用者。你會得到：三平台簽名安裝路徑、八步驗收、12 項報錯對照與 7×24 常駐主機結論。結構：痛點 → 環境表 → 八步落地 → 硬數據 → 平台對照 → FAQ。雙品租用場景請讀 OpenClaw & OpenHuman 雲 Mac 部署文。

六道安裝坑：為什麼 OpenHuman 不是「pip install 就能跑」

許多人把 OpenHuman 誤當成 Python 倉庫克隆加 requirements.txt 的舊路子——那是通用教學模板，與官方產品形態不符。2026 年主線是 TinyHumans 發布的 Rust + Tauri 桌面應用程式（GPL-3.0），UI 優先、幾輪點擊即可完成 onboarding。真實卡點往往是下列項目：

  1. 在主力機上直接 curl | bash：腳本會拉遠端程式碼並執行；資安社群與獨立評測均建議主力機改用 DMG / MSI / brew / apt 簽名鏈，先審核再裝。
  2. 混用安裝渠道：同一台機器既 brew 又 npm 全域 openhuman，PATH 衝突導致「已裝卻打不開」。
  3. 略過 macOS TCC 授權：螢幕智慧、Meet 數位人、鍵盤補全依賴螢幕錄製 / 輔助使用；拒絕權限後以為「功能壞了」。
  4. 只裝應用程式、未拉 Ollama 模型：設定裡選了 Local AI，但 ollama list 為空，推論一直逾時。
  5. 把 Memory Tree 當雲端同步：資料在本地 SQLite + Obsidian 相容 vault；換機未打包目錄就「記憶遺失」。
  6. 筆電合蓋當 7×24：背景思考與 Webhook 需要桌面工作階段在線；合蓋掛起後整合事件堆積。

與 OpenClaw 的一句話差異：OpenClaw 強在 CLI、Gateway 與 Telegram/WhatsApp 通道維運；OpenHuman 強在桌面 GUI、Memory Tree、118+ 整合（Gmail/Slack/Notion 等）與語音 / Google Meet 數位人。本篇只解決「裝得上、驗得過、接得住本地模型」；雙品對照見站內 雲 Mac 雙 Agent 文。

環境需求：最低配置與推薦生產檔

OpenHuman 早期 Beta（2026 年 5–6 月）對資源的要求高於一般聊天用戶端：需預留本地 vault、可選 Ollama 與螢幕智慧快取。下表按「僅雲端路由」與「本地 13B + Memory Tree」兩檔列出。

項目 最低（雲端模型） 推薦（本地 Ollama + 整合）
作業系統 macOS 12+、Win10 22H2+、Ubuntu 20.04+ macOS 14+（Apple Silicon）/ Win11 / Ubuntu 24.04
CPU / 晶片 4 核 x86_64 或 Apple M1 Apple M4 / M4 Pro（統一記憶體利於 Ollama）
記憶體 8 GB 16 GB（13B Q4）；70B 級請 64 GB+ 或純雲端
磁碟 5 GB（應用程式 + vault 起步） 40 GB+（Ollama 模型 + 日誌 + 整合快取）
GPU 無獨立顯示卡亦可（走 API） NVIDIA 可選；Apple Silicon 經 Ollama 走 Metal
網路 可存取訂閱路由與整合 OAuth 穩定低延遲；大模型首次拉取建議機房級頻寬
warning

安全提示：生產環境優先從 tinyhumans.ai/openhuman 或 GitHub Releases 下載已簽名安裝套件；curl | bash 僅建議在隔離 VM 或一次性測試機使用。

八步落地：三平台安裝 → 首次驗收 → Ollama → Memory Tree

以下步驟涵蓋 macOS / Windows / Linux；遠端 Mac 上透過 VNC 或本機主控台操作與本地一致。

  1. 選擇安裝通道（推薦簽名鏈）：macOS 用 Homebrew；Debian/Ubuntu 用官方 apt 源；Windows 用 Releases 的 .msi；均需驗證開發者簽名。
  2. 執行安裝：見下方各平台命令區塊；成功標誌為應用程式出現在啟動台/開始功能表，且版本 ≥ v0.56.0（2026 年 5 月線）。
  3. 首次啟動與帳戶：按精靈登入/建立 TinyHumans 帳戶（若使用訂閱模型路由）；可略過部分整合稍後再綁。
  4. 系統權限（macOS 必做）：在「系統設定 → 隱私與安全性」為 OpenHuman 開啟輔助使用、螢幕錄製、麥克風（若用語音/Meet）。
  5. 冒煙對話：在桌面輸入「總結我桌面上的待辦」類輕量任務，確認模型路由有回應（雲端或本地）。
  6. 安裝並啟動 Ollama：brew install ollama 或官網安裝套件 → ollama serve → ollama pull qwen2.5:7b（範例）。
  7. 在 OpenHuman 啟用 Local AI：設定 → Model Routing → Local AI，Base URL 填 http://127.0.0.1:11434，選擇已 pull 的模型；儲存後重試同一句 prompt。
  8. 驗收 Memory Tree：完成一次帶檔案/郵件上下文的任務後，在 vault 目錄（Obsidian 相容）查看是否產生節點；Settings 裡可查看 SQLite 記憶占用。

分平台安裝命令（2026 官方口徑）

bash · macOS
# 推薦：Homebrew tap（走系統簽名鏈）
brew tap tinyhumansai/core
brew install openhuman

# 或：官網 DMG / GitHub Releases 手動安裝
# https://github.com/tinyhumansai/openhuman/releases/latest

# 僅測試機可選（不推薦主力機）
# curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
bash · Debian/Ubuntu
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
powershell · Windows
# 推薦：下載已簽名 .msi
# https://github.com/tinyhumansai/openhuman/releases/latest

# 測試機可選（需先審閱腳本）
# irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
bash · Ollama 本地推論
brew install ollama    # 或 https://ollama.com/download
ollama serve           # 保持背景執行
ollama pull qwen2.5:7b # 16GB 統一記憶體友好
ollama list            # 確認模型 READY

# OpenHuman 設定內：Local AI → http://127.0.0.1:11434

可引用硬數據：版本、Stars 與 Memory Tree 機制

  • GitHub Stars（2026-06 口徑）：約 7,800+，GPL-3.0；穩定發行線 v0.56.0（2026-05-27），Beta 期迭代快，安裝前請在 Releases 核對 tag。
  • 架構選型：Rust 核心 + Tauri 桌面（非 Electron），社群評測稱閒置記憶體顯著低於典型 Electron Agent 用戶端——適合長期開著的個人助理場景。
  • Memory Tree：本地 SQLite + Obsidian 相容 vault，上下文經 canonicalize 折疊進 ≤3k token 樹節點；官方宣稱記憶容量設計可達十億 token 級索引（本地儲存，非雲端訓練）。

12 項常見報錯與現象對照表

報錯 / 現象 原因 處理
安裝後無法開啟 / 閃退 混裝渠道或殘留舊版 只保留一種安裝方式；完全解除安裝後重裝簽名套件
macOS「已損壞」提示 Gatekeeper 攔截未公證副本 僅用官網/Releases；勿用第三方網碟 repack
螢幕智慧無回應 未授螢幕錄製權 系統設定 → 隱私 → 螢幕錄製 → 勾選 OpenHuman
Local AI 一直 Pending Ollama 未啟動或連接埠錯 ollama serve；URL 用 127.0.0.1:11434
connection refused（Ollama） 防火牆 / 僅監聽遠端 本機呼叫禁止暴露 11434 到公網
推論極慢或 OOM 模型大於可用記憶體 改 7B/13B Q4；或關本地走雲端路由
Gmail/Slack 連不上 OAuth 未完成或企業策略攔截 用設定精靈重走授權；檢查代理伺服器
Memory Tree 空白 未產生可索引上下文 先完成一次帶檔案/郵件的任務；查 vault 路徑
Meet 數位人無畫面 攝影機/麥克風未授權 檢查 TCC 與瀏覽器外掛衝突
Linux 無 GUI 裝伺服器版無桌面 OpenHuman 需桌面工作階段；無頭請用 OpenClaw 等 CLI Agent
升級後設定遺失 未備份使用者目錄 升級前打包 Application Support 下 OpenHuman 資料
訂閱模型 429 路由限流 切換 Local AI 或稍後重試；檢查帳戶額度

部署平台對照：筆電、Linux 桌面與租 Mac Mini M4

裝通 OpenHuman 解決「能對話」；整合同步 + Memory Tree 複利解決「像認識你」——後者依賴主機長期在線且具備穩定 GUI 工作階段。

平台 7×24 可用性 本地 Ollama 適合
個人 MacBook 合蓋即斷 M 系列 Metal 體驗最佳 POC、當日除錯
Linux 桌上型電腦 可常駐但需桌面 NVIDIA CUDA 友好 已有顯示卡的工作站
x86 雲 VPS 高可用 無官方 GUI 路徑 不推薦跑 OpenHuman
租 Mac Mini M4 機房級在線 UMA + 遠端 VNC 排錯 要 Meet/螢幕智慧 + 本地 13B 生產

收束：簽名裝通只是第一步，常駐才決定 Memory Tree 是否「越用越像你」

按本文八步，多數讀者可在 45–90 分鐘 內完成 OpenHuman 桌面首通與 Ollama 本地冒煙。三條替代方案的短板也很明確：(a) 筆電合蓋會中斷 Webhook 與背景思考；(b) 無桌面 Linux 伺服器無法承載 Tauri GUI；(c) 自購 Mac Mini 要把硬體折舊、電費與 7×24 噪音壓在自己身上。

若你已驗證 OpenHuman 的 Memory Tree 與整合能替你省重複勞動、又希望 固定月費、SSH/VNC 十分鐘上崗、退租前可打包 vault 目錄，MACCOME 獨占 Mac Mini M4 雲節點通常是更優解：真實 Apple Silicon、與 brew/Ollama 命令完全相容，並適合作為與 OpenClaw 並行的第二台常駐桌面。雙品租用路徑可繼續讀 雲 Mac 雙 Agent 文，並在 租用價格頁 依區域下單。

常見問題

OpenHuman 必須用終端機安裝嗎？

不必。官方定位 UI-first：DMG/MSI/brew/apt 均可無終端機完成。終端機腳本適合自動化測試機。

能和 OpenClaw 裝在同一台 Mac 上嗎？

可以，注意記憶體與磁碟（Ollama 模型 + OpenClaw Gateway）。OpenClaw 通道維運見站內相關部落格；要 7×24 桌面+CLI 並存時建議 租用專用節點 或 32GB 檔。

M2/M3/M4 有差別嗎？

均支援；本地 Ollama 吞吐隨統一記憶體線性改善。16GB 跑 13B Q4 較穩，更大模型請升配或走雲端路由。

退租前如何遷移 OpenHuman 資料？

打包 macOS「應用程式支援」下 OpenHuman 目錄與 Obsidian vault 路徑即可。MACCOME 退租前支援自助清機；操作說明見 協助中心。