想在 2026 年把 OpenHuman 從「下載安裝」一路設定到 Memory Tree 首條請求成功、卻分不清 Homebrew / apt / curl 哪種更安全、或裝完登入 Gmail 後本機資料到底落在哪裡的開發者與 AI 初學者,本文是一條對齊 tinyhumansai/openhuman 官方路徑的保姆級指南:涵蓋 Windows / macOS / Linux 原生桌面安裝、onboarding、可選 Ollama 本機推理,以及何時該把持續 ingest 遷到雲 Mac。你將取得五大痛點拆解、雙對照表、六步實操與報錯速查。可與 租 Mac 跑 OpenClaw + OpenHuman 交叉閱讀。
01

2026 年 OpenHuman 是什麼?和 OpenClaw、ChatGPT 差在哪?

OpenHuman 是 Tiny Humans 發布的 GPL-3.0 開源桌面級個人 AI(Rust + Tauri + React),不是「git clone 後 pip install」的 Python 訓練倉庫。它把 Gmail、日曆、GitHub、本機檔案等連接源持續匯入基於 Markdown 的 Memory Tree(本機 SQLite + vault),讓你用自己機器上的上下文提問,而不是每次從零貼上聊天紀錄。

OpenClaw 相比:OpenClaw 偏訊息頻道 Gateway + CLI 自動化(Telegram/WhatsApp 等);OpenHuman 偏桌面 GUI、視覺化 onboarding、Memory Tree 與模型路由,更像「帶長期記憶的 Copilot 殼」。和網頁版 ChatGPT 相比:OpenHuman 預設把 vault 與資料庫落在本機,但登入、部分 OAuth 與模型路由仍可能走 OpenHuman 託管服務——裝完務必在設定裡分清本機 vs 雲端邊界

本文交付物:任選一種官方渠道裝好 → 完成登入與資料源連接 → 發出第一條基於 Memory Tree 的請求 →(可選)接上 Ollama。不涉及數位人影片渲染的第三方 Python Demo;若你需要在雲端 Mac 上同時跑 OpenClaw + OpenHuman + Ollama,請看鏈文雙棧部署。

01

指令稿管道風險:curl | bash / irm | iex 無獨立簽名校驗,官方 README 明確更推薦 Homebrew / 簽名 apt / MSI。

02

合蓋即斷 ingest:Memory Tree 設計為週期性拉取信箱與倉庫;筆電睡眠後上下文更新停滯,「越用越懂你」的曲線變平。

03

記憶體爭用:官方建議 4GB+ 可執行;大信箱 + 同機 Ollama 7B 建議 16GB+ 統一記憶體,否則 swap 抖動明顯。

04

OAuth 與託管邊界:預設登入、整合 OAuth、搜尋代理可能走雲端;敏感專案需讀文件中的 self-hosted / 自訂 RPC 路徑。

05

Early Beta:2026 年 6 月仍屬早期測試,頻道整合與本機 AI 路由行為可能隨版本變化,升級前備份 vault 目錄。

先選安裝渠道,再跟六步清單。若你手裡還有網上流傳的「Python 複製儲存庫 + checkpoints 目錄」舊大綱,請一律以 官方 GitBook 與 GitHub Releases 為準,避免把別的數位人訓練專案誤裝成 OpenHuman 桌面版。

02

OpenHuman 裝在哪?MacBook、Windows 桌機還是月租 Mac Mini?

OpenHuman 支援 macOS、Windows 10/11、Linux(Ubuntu 20.04+ 等)。純雲端 API 模式 4GB 記憶體可試跑;要 ingest 數十萬封郵件歷史並開本機模型,請按 16GB → 24GB → M4 Pro 64GB 遞進。Windows 使用者優先用簽名 MSI;macOS / Linux 開發者優先 Homebrew 或 apt

選型時建議把「能否 7×24 上線」與「是否需要 Metal 本機推理」分開評估:前者決定 Memory Tree 是否持續更新,後者決定你是否在同機跑 Ollama。Intel Mac 仍可安裝桌面版,但本機模型吞吐通常弱於 M 系列;Windows 桌上型若僅白天開機,夜間 ingest 仍會留下上下文空洞。團隊若已用 OpenClaw + OpenHuman 雙棧,可把 OpenClaw Gateway 與 OpenHuman 分到不同記憶體檔節點,避免單台 16GB 同時扛 Gateway、ingest 與 13B 模型。

部署平面Memory Tree 持續更新官方安裝路徑本機 Ollama月成本體感
個人 MacBook合蓋即停(≈60% 在線)Homebrew / DMG 高Metal 友好NT$0 硬體 + 焦慮
Windows 遊戲本睡眠/更新重啟打斷MSI 安裝包高視顯示卡而定已有硬體
x86 Linux 桌面≈95%(不關機)apt / AppImage可接 Ollama電費 + 維護
月租 Mac Mini M4機房 SLA ≈100%與本機相同指令UMA 扛 7B–13B固定 OpEx,可退租

安裝教學解決「能開啟 App」;平台選型解決「Memory Tree 能不能 7×24 複利」——大信箱生產使用者建議獨佔 macOS 節點。

03

OpenHuman 安裝渠道對比:Homebrew、apt、npm 與 curl 怎麼選?

官方文件將原生套件管理器列為推薦:走 OS 簽名鏈或倉庫 GPG,優於直接從 raw.githubusercontent.com 管道執行指令稿。下表為 2026 年 6 月主流路徑。

渠道適用系統安全體感典型指令
HomebrewmacOS / Linux高(tap + bottle)brew install tinyhumansai/openhuman/openhuman
aptDebian / Ubuntu高(GPG 倉庫)添加 openhuman.list 後 apt install openhuman
npm 全域跨平台 Node≥18中(SHA-256 校驗二進位)npm install -g openhuman
curl / irm 指令稿macOS / Linux / Win低(無獨立指令稿簽)僅應急;優先前三種
MSI / DMGWin / macOS高(Release 簽名包)GitHub Releases 下載安裝

macOS / Linux 推薦 Homebrew:

shell
brew install tinyhumansai/openhuman/openhuman
openhuman --version

Debian / Ubuntu 添加官方 apt 源後安裝(需 amd64):

shell
sudo apt-get install -y 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

提示:勿把 OpenHuman 與「Python 虛擬環境 + pip install -r requirements.txt」的舊教學混用;桌面版裝完應在應用程式列表看到 OpenHuman,首次啟動為「Sign in! Let's Cook」精靈。

npm 全域套件適合已統一 Node 18+ 工具鏈的開發者:首次安裝會下載平台二進位並做 SHA-256 校驗,執行時並不依賴 Node。國內網路若 GitHub / brew 較慢,可先在能穩定存取外網的機器完成安裝再把 vault 目錄打包遷移,或把雲 Mac 節點選在與你信箱資料中心更近的區域以降低 OAuth 回呼延遲。升級版本時優先走與初裝相同的渠道(brew upgrade / apt upgrade / MSI 覆蓋),避免混用腳本版與套件管理器版導致二進位路徑衝突。

04

六步把 OpenHuman 設定到 Memory Tree 首條請求成功

01

選渠道安裝:按上節完成 Homebrew / apt / MSI;裝後執行 openhuman 或從 Launchpad 開啟,確認版本號與 Release 說明一致。

02

登入 onboarding:首屏「Sign in! Let's Cook」選社交登入或企業 SSO;僅自建後端使用者在 Advanced 填自訂 core RPC URL。

03

連接資料源:按精靈連接 Gmail、日曆、GitHub 等;首次同步大信箱可能耗時數小時,保持機器喚醒。

04

劃清本機與託管:Memory Tree 資料庫、Markdown vault、workspace 設定在本機;登入、部分 OAuth、模型路由與搜尋代理可能走 OpenHuman 雲——合規專案請讀 GitBook 自建章節。

05

首條 Memory Tree 請求:在應用內提問需引用郵件/倉庫上下文的問題(如「總結上週某專案郵件串流」),確認回答引用了本機索引而非空泛幻覺。

06

(可選)Ollama 本機 AI:本機已裝 Ollama 時,在設定啟用 local-ai / model routing,輕任務走本機 7B,重推理走雲端;需要 7×24 ingest 則在 訂購入口 租獨佔 M4,SSH 重複同樣安裝步驟。

Windows PowerShell 應急指令稿(官方標註不如 MSI 安全):irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex。生產環境請從 GitHub Releases 下載簽名 MSI。

驗證安裝成功的三個訊號:應用關於頁版本號與 Release 一致;設定裡已連接的資料源顯示「上次同步」時間戳在流動;對 Memory Tree 提問時回答能引用具體郵件主題或 PR 編號而非泛泛而談。若首條請求仍像通用聊天,多半 ingest 未完成——可觀察使用者目錄下 vault 體積是否持續增長,或暫時縮小信箱同步範圍做冒煙測試。啟用 Ollama 後建議在活動監視器觀察記憶體壓力:swap 持續升高時把本機模型降到 7B 或把重推理任務路由回雲端,避免桌面 App 與推理程序互相拖死。

05

環境參數、報錯速查與何時遷雲 Mac

三條可引用口徑:① 官方 Getting Started 寫明 4GB+ RAM 可執行,ingest 超大信箱或同機 local model 建議 16GB+。② 授權為 GNU GPL-3.0,商用需自行評估 copyleft 義務。③ Memory Tree 設計為約 每 20 分鐘 從已連接源增量更新(beta 階段行為以當前版本 Release Note 為準)。④ 2026 年 6 月 GitHub 星標已突破兩萬量級,桌面版以 Rust 為主、TypeScript 為 UI 層,迭代頻率高,生產環境請鎖定 Release 版本號並保留升級前 vault 快照。

現象常見原因處理
安裝後找不到指令PATH 未含 brew/npm 前綴重開終端機或 brew link openhuman
登入一直轉圈網路 / 代理攔截 OAuth檢查系統代理與防火牆 443
回答與郵件無關同步未完成等待 ingest 進度,查本機 vault 體積增長
Ollama 無回應模型未 pull / 連接埠占用ollama list 與設定內 endpoint
升級後設定遺失未備份 workspace升級前打包 vault 與 SQLite 目錄

備份建議:定期複製 vault 與 SQLite 到 Time Machine 或物件儲存;解除安裝前在應用內中斷 OAuth 並刪除本機快取,避免舊權杖殘留。

攤開替代方案:合蓋 MacBook 能裝好卻守不住 Memory Tree 更新;廉價 Linux VPS 無官方 Windows 級 GUI 體驗且難接桌面 OAuth 流程;只用 curl 指令稿 省去套件管理器卻犧牲供應鏈安全。在 KVMNODE 租用獨佔 Mac Mini M4,用與本機相同的 Homebrew 路徑、機房不斷電不斷網,讓 Gmail ingest 與可選 Ollama 7B 在 UMA 上並行——對大信箱知識工作者與要把 OpenHuman 當「第二大腦」的團隊,通常比「偶爾開機的筆電 + 過期上下文」更省心。檔位見 定價頁,交付與網路見 幫助中心