macOS Homebrew · Memory Tree · 118+ OAuth 整合 · 常見報錯速查 · VNC 遠端 Mac 驗收
OpenHuman 是 tinyhumansai 開發的開源桌面個人 AI Agent——不是又一個聊天視窗，而是把記憶、工具、整合與語音匯成一套本機智慧層。2026 年 5 月發布 v0.56.0，GitHub Stars 已超過 3 萬。本文基於最新版本，完整涵蓋 macOS Homebrew 安裝（推薦路徑）、首次啟動與 LLM 設定、Memory Tree 接入、118+ OAuth 整合授權、常見報錯 10 條速查表，以及在 VNC 遠端 Mac 上的 20 分鐘驗收清單；與站內 OpenClaw & OpenHuman 部署指南、Hermes Agent 安裝教學 互為補充。
OpenHuman 的自我定位是「Personal AI super intelligence」——私密、簡潔、極具擴充性。與 OpenClaw（終端機優先、BYO 模型）或 Hermes Agent（同樣終端機優先）不同，OpenHuman 是桌面 GUI 優先：它有一個會說話、會對周圍環境做出反應的桌面吉祥物（mascot），並在背景持續執行，即使你停止鍵盤輸入仍在感知上下文。這套體驗在首次部署時，也帶來五類最常見的挫折：
純 SSH 無法過 TCC 彈窗：輔助使用、通知、麥克風、完全磁碟存取——macOS 的隱私權限必須在圖形桌面點選「允許」，終端機 SSH 工作階段看不到這些對話框。
OAuth 回呼需要瀏覽器：118+ 連接器（Gmail、GitHub、Notion、Slack 等）各自走 OAuth 跳轉，預設瀏覽器必須能回到本機 58080–58090 回呼埠，否則整合授權失敗。
Memory Tree 首次同步「像卡住」：10–25 分鐘的向量化掃描在進度條 0% 停留很久，使用者常誤以為當機而強制退出——反而要重跑一遍。
Homebrew 與 Xcode CLT 的 GUI 依賴：首次 brew install 可能觸發 Command Line Tools 安裝彈窗；無 VNC 的遠端節點會在這一步靜默失敗。
Early Beta 的更新與報錯：v0.56 仍屬 Early Beta，WebKit 程序崩潰、API Key 格式、自動更新權限等問題需要對照 Release Notes 與日誌目錄 ~/Library/Logs/tinyhumansai/。
對於不想從命令列折騰環境、希望 AI 能真正感知你日常工作流的使用者，OpenHuman 的 GUI 優先策略與 118+ 連接器是核心競爭力。但正因為它依賴圖形介面，在沒有 VNC 的純 SSH 遠端環境裡首次授權時會遇到不少麻煩——這正是 VNC 遠端 Mac 的用武之地。
技術棧方面，OpenHuman 使用 Rust + Tauri + React 建構，授權協議為 GNU GPL-3.0。最新穩定版為 v0.56.0（2026-05-27），仍處於 Early Beta 階段——功能迭代活躍，升級時注意查閱 Release Notes。以下是它與同類工具的核心差異：
| 對照維度 | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| 開源協議 | ✅ GNU GPL-3.0 | ✅ MIT | ✅ MIT | 🚫 專有 |
| 操作介面 | ✅ 桌面 GUI（分鐘級） | ⚠️ 終端機優先 | ⚠️ 終端機優先 | ✅ 桌面 + CLI |
| 記憶系統 | ✅ Memory Tree + Obsidian Vault | ⚠️ 外掛依賴 | ✅ 三層記憶（自學習） | ✅ 工作階段級 |
| 第三方整合 | ✅ 118+ OAuth 連接器 | ⚠️ 自行接入 | ⚠️ 自行接入 | ⚠️ 少量連接器 |
| 自動同步 | ✅ 每 20 分鐘同步進記憶 | 🚫 無 | 🚫 無 | 🚫 無 |
| 模型路由 | ✅ 內建（含 TokenJuice） | ⚠️ 手動 | ⚠️ 手動 | 🚫 單模型 |
| 成本 | ✅ 一個訂閱 + TokenJuice | ⚠️ 自備模型金鑰 | ⚠️ 多供應商 | ⚠️ 訂閱+附加項 |
對於一般使用者（直接安裝二進位包），OpenHuman 幾乎沒有額外執行時依賴——只需 macOS 12 Monterey 及以上（推薦 macOS 14 Sonoma / 15 Sequoia / 26 Tahoe），Homebrew 或直接下載 .dmg 即可。對於開發者或從原始碼編譯的使用者，要求則高得多：
| 依賴項 | 二進位安裝（一般使用者） | 原始碼編譯（開發者） |
|---|---|---|
| macOS 版本 | 12 Monterey+（推薦 14+） | 同左 |
| Node.js | 不需要 | 24+（見 app/package.json） |
| pnpm | 不需要 | 10.10.0（packageManager 欄位固定） |
| Rust | 不需要 | 1.93.0（rust-toolchain.toml 指定） |
| CMake | 不需要 | 必須（Rust native 依賴） |
| Xcode CLT | Homebrew 可能觸發 | 必須（macOS 桌面建置工具） |
| GPU / CUDA | 不需要 | 不需要 |
重要說明：OpenHuman 使用 Tauri（WebKit 渲染）而非 Electron，AI 推理透過設定的 LLM 提供商完成（API 呼叫或本機 Ollama），本機無需 GPU。Apple M1/M2/M3/M4 晶片機器均可流暢執行。記憶體 8GB 夠日常使用，啟用 Memory Tree 後建議 16GB 以上以減少 swap 壓力。應用程式本體約 150–200MB，Memory Tree 資料庫隨使用時間成長（初始約 500MB，長期使用可能達到 2–5GB）。
tinyhumansai 提供四種安裝方式：Homebrew tap（推薦，走系統套件管理器簽名鏈）、官網下載 .dmg（次選）、curl 腳本安裝（不推薦，無完整性驗證）、以及從原始碼編譯（僅開發者）。以下重點講解 Homebrew 路徑。
確認 Homebrew 已安裝：打開終端機（Terminal.app 或 iTerm2），執行 brew --version。若提示指令不存在，先執行官方安裝腳本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安裝 Homebrew 時會自動觸發 Xcode Command Line Tools 安裝彈窗，在圖形介面點選「安裝」即可。這正是 VNC 的優勢所在——純 SSH 無法回應這類 GUI 提示。
添加 tinyhumansai Homebrew tap 並安裝：
brew tap tinyhumansai/core brew install openhuman
首次 tap 會從 GitHub 拉取 Formula 定義，隨後 brew install 下載預編譯二進位包並驗證校驗和。安裝完成後 OpenHuman.app 出現在 ~/Applications 中。
首次啟動與輔助使用授權：在 Spotlight（⌘ + Space）中搜尋「OpenHuman」並打開。macOS 會彈出輔助使用與通知權限請求——點選「打開系統設定」，進入「隱私與安全性 → 輔助使用」，勾選 OpenHuman。若只在 SSH 做這步，權限彈窗無法顯示。
Onboarding：設定 LLM 提供商：首次啟動進入引導流程，選擇 AI 大腦。支援 Claude（Anthropic）、OpenAI GPT-4o/mini、Gemini 1.5/2.0、Grok（xAI）及本機 Ollama。填入對應 API Key（或選 TokenJuice 統一帳單）。建議優先選用支援長上下文的模型（如 Claude Sonnet 系列），以充分發揮 Memory Tree 的價值。
授權 OAuth 整合（118+ 連接器）：進入 Settings → Integrations，選擇需要連接的平台（Google Drive/Gmail/Calendar、GitHub、Notion、Slack 等）。每個整合都會打開瀏覽器 OAuth 授權頁——必須在圖形桌面上完成點選授權，SSH 終端機無法彈出瀏覽器視窗。
開啟 Memory Tree 並完成首次同步：進入 Settings → Memory → Memory Tree，點選「Enable」。首次同步會掃描已授權整合中的郵件、文件、程式碼、日曆摘要，進行向量化並寫入本機知識圖譜。耗時約 10–25 分鐘，取決於資料量與網路條件。期間保持應用程式在前台或至少不強制退出。
驗證首次對話：對話框輸入「你好，我昨天發了什麼郵件？」（已接入 Gmail）或「幫我回顧本週 GitHub PR」。若 OpenHuman 能基於 Memory Tree 給出有上下文的回答，說明設定成功。
Memory Tree 是 OpenHuman 與其他個人 AI 工具最顯著的差異化特性：它不是工作階段級上下文，而是跨來源、可檢索的個人知識圖譜——把郵件摘要、程式碼 PR、文件筆記、日曆事件等異質資料融合進同一向量空間，每隔約 20 分鐘增量更新。
在 Settings → Memory → Memory Tree 中可調整同步間隔（最低 5 分鐘，預設 20 分鐘）與各資料來源的同步範圍（如限制 Gmail 僅同步最近 90 天）。範圍越大，首次同步越慢，但召回精度更高。建議先以預設值跑一週，觀察記憶品質後再調整。
若你使用 Obsidian 做個人知識管理，OpenHuman 支援將 Vault 目錄直接納入 Memory Tree。進入 Settings → Memory → Local Sources，添加 Vault 根目錄路徑。OpenHuman 會監聽 Markdown 檔案變動並增量更新向量索引，無需手動觸發。
注意：Vault 接入是唯讀的——OpenHuman 不會修改你的 .md 檔案，僅從中讀取向量化內容。若需要讓 OpenHuman 往 Vault 裡寫筆記，需要設定 Obsidian 的 URI 接入（Settings → Integrations → Obsidian Write）。
不想讓某些郵件或檔案進入記憶？有兩種方式：①在 Integrations 裡為特定連接器添加排除關鍵字（如 "label:payroll"）；②在 Local Sources 裡指定排除目錄（如 .private/）。Memory Tree 的本機資料庫儲存在 ~/.openhuman/memory/，可直接備份或遷移到另一台 Mac。
OpenHuman 仍處於 Early Beta，下表彙總了使用者最常遇到的 10 類問題及解決方向：
| # | 報錯 / 現象 | 常見原因 | 解決方向 |
|---|---|---|---|
| 1 | brew install 報 404 或 tap 失敗 | Formula 檔案 URL 變更、網路逾時 | brew update 更新 tap，或改用官網下載 .dmg |
| 2 | 首次啟動崩潰，日誌含 "WebKit process terminated" | macOS 版本過低（低於 12）或 WebKit 快取損壞 | 確認 macOS ≥ 12，刪除 ~/Library/WebKit/tinyhumansai 後重啟 |
| 3 | 輔助使用權限彈窗一閃而過 | 快速登入或應用程式未成功註冊 TCC | 系統設定 → 隱私與安全性 → 輔助使用，手動添加 OpenHuman |
| 4 | OAuth 授權後回呼失敗 | 預設瀏覽器不是 Safari/Chrome，或本機回呼埠被占用 | 檢查是否有其他應用程式占用 58080–58090 埠；換預設瀏覽器再試 |
| 5 | Memory Tree 同步卡在 0% | 網路問題或 OAuth Token 已失效 | 檢查網路，在 Integrations 裡重新授權對應連接器 |
| 6 | LLM 回覆為空或報"API Key invalid" | API Key 錄入有誤，或帳戶餘額不足 | Settings → LLM 重新填寫並點"Test Connection"；檢查供應商控制台 |
| 7 | 應用程式提示"New version available"後更新失敗 | 自動更新路徑權限不足（非 Homebrew 安裝） | brew upgrade openhuman，或手動下載新版 .dmg 覆蓋安裝 |
| 8 | 桌面吉祥物（mascot）不顯示 | 顯示縮放率過高或輔助使用權限不足 | 降低顯示縮放至 Retina 預設值；重新檢查輔助使用授權 |
| 9 | Obsidian Vault 監聽無效 | Vault 路徑含空格或特殊字元，或路徑權限不足 | 用引號括起路徑重新添加；檢查「完全磁碟存取權限」是否已開啟 |
| 10 | 語音功能無聲音或無法錄音 | 麥克風/揚聲器權限未授權，或音訊驅動衝突 | 系統設定 → 隱私 → 麥克風，添加 OpenHuman；重啟應用程式 |
遇到上表未涵蓋的問題，優先查看 ~/Library/Logs/tinyhumansai/ 目錄下的應用程式日誌，或造訪 tinyhumansai 的 GitHub Issues 搜尋已知 Bug。
OpenHuman 是桌面 GUI 優先的工具，安裝與初始設定的多個關鍵步驟必須透過圖形介面完成，SSH only 工作階段無法處理：
以下是在 VNCMac 租用的遠端 Mac 上完成 OpenHuman 部署的驗收清單（預計 20 分鐘，網速穩定時）：
連接遠端 Mac（VNC）：用 VNC Viewer / Microsoft Remote Desktop 連接 VNCMac 節點，確認桌面已顯示。解析度建議 1440×900 或更高，以便點選系統設定中的小按鈕。
安裝 Homebrew + OpenHuman：打開 Terminal.app，執行上文 04 節步驟 1–2。若觸發 Xcode CLT 安裝彈窗，在 VNC 桌面點選「安裝」即可，無需切換到本機機器。
首次啟動與權限授權：在 VNC 桌面 Finder 中找到 ~/Applications/OpenHuman.app 打開，或透過 Spotlight 啟動。依序回應輔助使用、通知、完全磁碟存取等系統權限彈窗，全部點選「允許」。
設定 LLM 並授權整合：在 VNC 桌面的瀏覽器中完成 OAuth 跳轉。如需登入 Google/GitHub 帳號，確保遠端 Mac 上的 Safari 或 Chrome 是預設瀏覽器，OAuth 回呼才能正常返回 OpenHuman。
驗證 Memory Tree 同步：在 VNC 桌面觀察 Settings → Memory 中的同步進度條，等待首次同步完成（綠色對勾）。提問驗證：「我最近哪個 GitHub repo 提交最活躍？」——有上下文回答即代表設定完成。
完成以上 5 步後，OpenHuman 已進入日常可用狀態。遠端 Mac 上的 OpenHuman 可以 7×24 在線感知整合資料，而你在本機 Windows/Linux 機器上也能隨時 VNC 進來檢查和對話，無需每次從頭設定。
第一組可引用事實：① OpenHuman v0.56 推薦 brew tap tinyhumansai/core && brew install openhuman，二進位安裝不需要 Node/Rust/GPU。② Memory Tree 預設每 20 分鐘增量同步，首次向量化通常 10–25 分鐘，期間勿強制退出。③ 118+ OAuth 連接器與 TCC 權限彈窗均需在圖形桌面完成，純 SSH 不足以完成首次部署。
第二組可引用事實：④ 本機資料目錄 ~/.openhuman/memory/ 可備份遷移；Obsidian Vault 接入為唯讀，寫入需另配 URI 整合。⑤ OAuth 回呼埠 58080–58090 被占用時授權會失敗——換預設瀏覽器或釋放埠後重試。⑥ 在 VNCMac 遠端 M4 節點上，SSH 負責 brew 與日常升級，VNC 負責首次 GUI 授權——這是 OpenHuman 與純 CLI Agent 在遠端 Mac 上最大的流程差異。
若你正在評估「自購 Mac mini 7×24 跑 OpenHuman」還是「按月租用帶 VNC 的遠端 Mac」，建議先用 20 分鐘驗收清單在租用節點跑通 Memory Tree 與 OAuth，再決定是否買斷硬體——Early Beta 階段功能迭代快，OpEx 試跑比 upfront CapEx 更省決策成本。
可以。OpenHuman 使用 Tauri（WebKit）渲染 UI，AI 推理透過設定的 LLM 提供商完成（API 或本機 Ollama），對本機 GPU 無強制要求。Apple Silicon M 系晶片的神經網路引擎（ANE）可輔助本機 Ollama 推理，但非必須。
首次開啟 Memory Tree 時，OpenHuman 掃描已授權連接器的歷史資料，向量化後寫入本機知識圖譜。通常耗時 10–25 分鐘，資料量越大越慢。期間應保持網路穩定，不要強制退出應用程式。
tinyhumansai 官方警告該方式無腳本位元組級完整性驗證，優先推薦 Homebrew tap 或官網簽名 .dmg。若必須用腳本，應先下載到本機檔案、人工檢查內容後再執行，避免供應鏈攻擊風險。
支援 Claude（Anthropic）、OpenAI GPT 系列、Gemini、Grok（xAI）及本機 Ollama。也可設定 TokenJuice 統一帳單以減少多供應商 API sprawl。Settings → LLM 中填入對應 API Key 後點「Test Connection」驗證。
Homebrew 安裝的使用者執行 brew upgrade openhuman；.dmg 安裝的使用者在應用程式內點選「Check for updates」或從 GitHub Releases 手動下載新版覆蓋安裝。Early Beta 階段建議訂閱 GitHub Release 通知，重大變更時提前查閱 Release Notes。
首次啟動時的輔助使用、通知、磁碟存取權限彈窗以及 OAuth 瀏覽器授權頁，均需透過 VNC 圖形介面回應，SSH 工作階段無法處理。其餘日常對話與命令列操作（brew upgrade 等）可在 SSH 中完成，僅「需要點選的步驟」依賴 VNC。
OpenHuman 的價值主張很清晰：用 GUI 降低 AI Agent 的上手門檻，用 Memory Tree 讓 AI 真正了解你的工作上下文，用 118+ OAuth 連接器把數位生活的各個碎片拼成一個可查詢的整體。但這一切的代價是桌面圖形介面的持續依賴：首次設定、OAuth 授權、權限彈窗、Memory 同步視覺化——每一步都需要你能看到並點選螢幕。
如果你的主力機是 Windows 或 Linux，或者想讓 OpenHuman 在不帶顯示器的 Mac 上 7×24 持續執行，純 SSH 工作階段會在首次設定時就卡住。自購一台 Mac mini 或 MacBook 放在家裡做伺服器固然可行，但需要承擔折舊、電費與偶發斷電的風險。相比之下，租用一台帶 VNC 圖形介面的遠端 Mac，既能完成所有 GUI 授權操作，又不需要在本機維護硬體——這正是許多開發者在把 OpenHuman 變成「常駐個人 AI 層」時選擇 VNCMac 的原因。下一步可前往 Mac 租用方案 或瀏覽 產品首頁 了解節點規格。