2026 OpenHuman 完整安裝與設定指南:
保姆級從零到跑通與 Mac Mini 常駐選型

2026 年 OpenHuman(TinyHumans,GPL-3.0)把「個人 AI」做成本機優先的桌面 Agent:Rust + Tauri 殼、SQLite Memory Tree、Obsidian 相容知識庫,以及 Gmail/Notion/GitHub 等 118+ 一鍵 OAuth 整合。若你被網上過時的「pip + 數位人權重」教學誤導,或卡在安裝簽章、首次同步、Ollama 本機模型,這篇按官方 README 整理的 Runbook 幫你從下載到可用 Agent,並對比 MacBook / VPS / Mac Mini M4 月租 誰適合 7×24 常駐。

01

OpenHuman 是什麼?為什麼 2026 年值得裝

OpenHuman 不是「上傳一段影片生成數位人」的 Python 推理專案,而是常駐桌面的 Agent harness:UI 優先、幾分鐘內完成帳號連接與 Memory Tree 建構,背景每約 20 分鐘 auto-fetch 拉取信箱/日曆/儲存庫等上下文,再經 TokenJuice 壓縮後餵給模型路由。與終端優先的 OpenClaw、Hermes 相比,它強調少配 API、多接 OAuth、記憶在本機 SQLite + Markdown 金庫

本文結構對齊完整安裝大綱:環境 → 簽章安裝 → 首次驗收 → Ollama/整合進階 → 主機選型。若你已在跑 Hermes 保姆級安裝文OpenClaw 生產部署,可把 OpenHuman 當作「帶臉、帶記憶樹」的桌面層,與 NodeMini 遠端 Mac 組合使用。

  1. 01

    痛點:誤用舊教學 pip install -r requirements.txt,與當前桌面發行版無關。

  2. 02

    痛點:直接 curl | bash 安裝,無法驗證腳本完整性(官方已標註風險)。

  3. 03

    痛點:連接 Gmail/Notion 後 Agent 仍「失憶」——未完成首輪 sync 或 vault 路徑錯誤。

  4. 04

    痛點:Linux Wayland 下 AppImage 閃退(社群 issue #2463)。

  5. 05

    痛點:筆電合蓋,auto-fetch 與 Meet 代理中斷。

  6. 06

    本文交付:六步從簽章套件安裝到 Memory Tree 驗收的清單。

02

環境要求:最低配置 vs 推薦配置(2026-06)

OpenHuman 為原生桌面應用,不強制 NVIDIA GPU;本機 Ollama 路徑在 Apple Silicon 上更常見。下表綜合官方 README 與 Early Beta 社群回饋(非 SLA):

配置項最低要求推薦(7×24 + 多整合)
作業系統macOS 12+ / Win10+ / Ubuntu 20.04+ amd64macOS 14+(Apple Silicon)或 Ubuntu 24.04 LTS
記憶體8 GB(僅雲端路由)16–32 GB;本機 Ollama 建議 32 GB+
磁碟約 2 GB 應用 + 快取50 GB SSD+(Memory Tree + vault 成長)
網路可存取 tinyhumans.ai 與 OAuth穩定低延遲、足夠頻寬(auto-fetch 與 Meet 代理)
從原始碼建置Node.js 24+、pnpm 10.10、Rust 1.93(僅貢獻者)

「裝 OpenHuman 最難的一步,往往不是點安裝,而是選一台不會在凌晨掉線的 Mac。」

03

六步落地:簽章安裝 → 登入 → 整合 → Memory Tree 驗收

優先:原生套件 / 簽章安裝套件(推薦)

bash · macOS
# 方式 A:官網 DMG(主機器推薦,可驗開發者簽章)
# https://tinyhumans.ai/openhuman

# 方式 B:Homebrew(走 bottle 雜湊鏈)
brew tap tinyhumansai/core
brew install openhuman
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
warning

不建議預設路徑:curl … install.sh | bash 腳本無獨立簽章校驗,官方 README 明確建議優先 DMG / Homebrew / apt / 簽章 MSI。若必須用腳本,等 #2620 的 GPG 驗證流程發布後再用。

  1. 01

    下載並安裝:tinyhumans.ai/openhuman 或 GitHub Releases 取對應平台安裝套件;Windows 用簽章 .msi

  2. 02

    首次啟動:完成帳號登入(預設走 OpenHuman 託管的模型路由與 Composio OAuth 代理;可在設定中切換 BYO Key)。

  3. 03

    連接 1–2 個整合:建議先 Gmail + GitHub 或 Notion,觀察 OAuth 精靈是否成功。

  4. 04

    等待首輪 auto-fetch:約 20 分鐘週期;在 Memory Tree / Obsidian vault 目錄應出現 ≤3k token 的 Markdown 區塊。

  5. 05

    驗收對話:問「總結我本週日曆與未讀郵件要點」——若回答引用本機上下文,說明 sync 生效。

  6. 06

    (可選)本機模型:設定 → Model Routing → Ollama,確保本機 ollama serve 已跑(可參考站內 Ollama × 租用 Mac 指南)。

常見報錯對照

報錯 / 現象原因處理
AppImage 啟動即當機Wayland / sharun 相容改用 .deb 套件或文件中的環境變數 workaround
整合連上但 Agent 無上下文首輪 sync 未完成等待 auto-fetch 週期,檢查 vault 是否寫入
OAuth 反覆失敗系統時間漂移 / 代理攔截校準 NTP,放行 tinyhumans.ai 與 Composio 網域
04

進階:Ollama、agentmemory 與 7×24 主機怎麼選

本機推理:OpenHuman 支援透過 Ollama 跑部分 on-device 工作負載,敏感步驟可不出雲。跨 Agent 記憶:若你已部署 agentmemory,可在 config.tomlmemory.backend = "agentmemory",與 Cursor/Codex 等共用儲存(見官方 GitBook)。

要把 OpenHuman 當成「永遠在線的個人參謀」,主機必須扛住背景 sync、語音與 Meet 代理。下表為選型參考:

平台7×24 可用性Memory Tree 複利適合場景
個人 MacBook合蓋即斷auto-fetch 頻繁中斷試用 / 展示
Linux VPS 無 GUI在線率高缺原生桌面與 Tauri 體驗不建議作主環境
Mac Mini M4 月租機房託管常在線GUI + Ollama UMA + vault 本機碟多整合 + 背景 Agent
info

遠端 Mac 提示:租一台獨佔 Mac Mini 後,用 VNC/螢幕共享完成首次 OAuth,日常可用 SSH 維護 Ollama 與磁碟;安裝步驟與本機一致。

05

可引用參數與結論:裝完 OpenHuman 後主機怎麼選

  • 當前版本線:GitHub 發布頁 v0.56.x 量級(2026-05/06,Early Beta,介面可能變)。
  • 整合規模:官方文件口徑 118+ 第三方連接,預設 Composio 託管 OAuth。
  • 記憶架構:SQLite Memory Tree + Obsidian 相容 .md 金庫,單塊約 ≤3k token。
  • TokenJuice:工具輸出經壓縮後再進模型,文件稱最高約 80% token 節省(隨內容類型變化)。

若你只是週末體驗桌面 mascot,本機安裝足夠;一旦要讓 Gmail/日曆/儲存庫上下文每天自動沉澱,合蓋休眠與家用斷網會把「幾分鐘上手」打回「幾週重新餵資料」。先 月租驗證 30 天工作流 再決定是否自購 Mac Mini,決策成本最低。

低配 VPS 伺服器無 GUI、鄰居超售、樹莓派磁碟 IO,都不適合作為 OpenHuman 主戰場——而使用者只會覺得「Agent 又忘了我是誰」。對需要穩定 7×24 桌面 Agent、本機 vault 與 Ollama 統一記憶體的生產環境,NodeMini 的 Mac Mini M4 雲端租賃通常比「將就的筆電 + 手動重啟」更省心:你專注記憶複利,而不是半夜修 OAuth。

FAQ

常見問題

不是。TinyHumans 的 OpenHuman 是 Rust/Tauri 桌面 Agent,安裝方式為 DMG/Homebrew/apt,而非 git clone + pip install 訓練數位人權重。請認準 github.com/tinyhumansai/openhuman

NodeMini 提供獨佔 Mac Mini M4 按月租賃,價格見 租賃價格說明。OpenHuman 訂閱與第三方 LLM 費用仍由你向 TinyHumans / 模型商自行支付。

可以。預設雲端模型路由;本機路徑可接 Ollama 利用 Apple Silicon Metal。SSH 與遠端桌面問題見 說明中心