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 常駐。
OpenHuman 不是「上傳一段影片生成數位人」的 Python 推理專案,而是常駐桌面的 Agent harness:UI 優先、幾分鐘內完成帳號連接與 Memory Tree 建構,背景每約 20 分鐘 auto-fetch 拉取信箱/日曆/儲存庫等上下文,再經 TokenJuice 壓縮後餵給模型路由。與終端優先的 OpenClaw、Hermes 相比,它強調少配 API、多接 OAuth、記憶在本機 SQLite + Markdown 金庫。
本文結構對齊完整安裝大綱:環境 → 簽章安裝 → 首次驗收 → Ollama/整合進階 → 主機選型。若你已在跑 Hermes 保姆級安裝文 或 OpenClaw 生產部署,可把 OpenHuman 當作「帶臉、帶記憶樹」的桌面層,與 NodeMini 遠端 Mac 組合使用。
痛點:誤用舊教學 pip install -r requirements.txt,與當前桌面發行版無關。
痛點:直接 curl | bash 安裝,無法驗證腳本完整性(官方已標註風險)。
痛點:連接 Gmail/Notion 後 Agent 仍「失憶」——未完成首輪 sync 或 vault 路徑錯誤。
痛點:Linux Wayland 下 AppImage 閃退(社群 issue #2463)。
痛點:筆電合蓋,auto-fetch 與 Meet 代理中斷。
本文交付:六步從簽章套件安裝到 Memory Tree 驗收的清單。
OpenHuman 為原生桌面應用,不強制 NVIDIA GPU;本機 Ollama 路徑在 Apple Silicon 上更常見。下表綜合官方 README 與 Early Beta 社群回饋(非 SLA):
| 配置項 | 最低要求 | 推薦(7×24 + 多整合) |
|---|---|---|
| 作業系統 | macOS 12+ / Win10+ / Ubuntu 20.04+ amd64 | macOS 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。」
# 方式 A:官網 DMG(主機器推薦,可驗開發者簽章) # https://tinyhumans.ai/openhuman # 方式 B:Homebrew(走 bottle 雜湊鏈) brew tap tinyhumansai/core brew install openhuman
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 … install.sh | bash 腳本無獨立簽章校驗,官方 README 明確建議優先 DMG / Homebrew / apt / 簽章 MSI。若必須用腳本,等 #2620 的 GPG 驗證流程發布後再用。
下載並安裝:從 tinyhumans.ai/openhuman 或 GitHub Releases 取對應平台安裝套件;Windows 用簽章 .msi。
首次啟動:完成帳號登入(預設走 OpenHuman 託管的模型路由與 Composio OAuth 代理;可在設定中切換 BYO Key)。
連接 1–2 個整合:建議先 Gmail + GitHub 或 Notion,觀察 OAuth 精靈是否成功。
等待首輪 auto-fetch:約 20 分鐘週期;在 Memory Tree / Obsidian vault 目錄應出現 ≤3k token 的 Markdown 區塊。
驗收對話:問「總結我本週日曆與未讀郵件要點」——若回答引用本機上下文,說明 sync 生效。
(可選)本機模型:設定 → Model Routing → Ollama,確保本機 ollama serve 已跑(可參考站內 Ollama × 租用 Mac 指南)。
| 報錯 / 現象 | 原因 | 處理 |
|---|---|---|
| AppImage 啟動即當機 | Wayland / sharun 相容 | 改用 .deb 套件或文件中的環境變數 workaround |
| 整合連上但 Agent 無上下文 | 首輪 sync 未完成 | 等待 auto-fetch 週期,檢查 vault 是否寫入 |
| OAuth 反覆失敗 | 系統時間漂移 / 代理攔截 | 校準 NTP,放行 tinyhumans.ai 與 Composio 網域 |
本機推理:OpenHuman 支援透過 Ollama 跑部分 on-device 工作負載,敏感步驟可不出雲。跨 Agent 記憶:若你已部署 agentmemory,可在 config.toml 設 memory.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 |
遠端 Mac 提示:租一台獨佔 Mac Mini 後,用 VNC/螢幕共享完成首次 OAuth,日常可用 SSH 維護 Ollama 與磁碟;安裝步驟與本機一致。
.md 金庫,單塊約 ≤3k token。若你只是週末體驗桌面 mascot,本機安裝足夠;一旦要讓 Gmail/日曆/儲存庫上下文每天自動沉澱,合蓋休眠與家用斷網會把「幾分鐘上手」打回「幾週重新餵資料」。先 月租驗證 30 天工作流 再決定是否自購 Mac Mini,決策成本最低。
低配 VPS 伺服器無 GUI、鄰居超售、樹莓派磁碟 IO,都不適合作為 OpenHuman 主戰場——而使用者只會覺得「Agent 又忘了我是誰」。對需要穩定 7×24 桌面 Agent、本機 vault 與 Ollama 統一記憶體的生產環境,NodeMini 的 Mac Mini M4 雲端租賃通常比「將就的筆電 + 手動重啟」更省心:你專注記憶複利,而不是半夜修 OAuth。
不是。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 與遠端桌面問題見 說明中心。