OpenHuman 安裝教學（2026 最新版）：5 分鐘搭建你的 AI 數位分身

AI 手記  ·  2026.05.29  ·  約 10 分鐘閱讀

使用者在桌面使用筆電安裝設定 OpenHuman 個人 AI 數位分身

若你已在 GitHub 上看到 OpenHuman 卻還沒動手，這篇就是2026 年最短的落地路徑：從下載安裝到第一次讓 Agent 說出「我知道你今天下午有會」——全程照表操作，熟練使用者約 5 分鐘（含 OAuth 彈窗與首輪同步等待）。OpenHuman 不是又一個聊天網頁，而是桌面級個人 AI 數位分身：本機記憶樹、118+ 服務 OAuth、約 20 分鐘一輪的背景同步。裝好之後，你可以再讀我們關於架構與記憶樹、Agent Skill 的深度文章；本文只解決「怎麼裝、怎麼設、怎麼確認成功」。

5
分鐘上手（含 OAuth）
118+
可 OAuth 整合
20
分鐘同步週期

安裝前要準備什麼

OpenHuman 是 Tauri 桌面應用程式（Rust 核心 + Web UI），官方支援 macOS、Windows、Linux。2026 年主流路徑仍以 Apple Silicon Mac 體驗最好——與本機 Ollama、MLX 推論同機部署時延遲更低。安裝前請確認：

  • 系統權限— macOS 需在「隱私權與安全性」裡允許下載的 App（或從 App Store 以外安裝時右鍵「打開」）。
  • 至少一組 LLM 憑證— Anthropic / OpenAI API Key，或本機已執行的 Ollama（選用）。沒有 Key 也能進介面，但 Agent 無法推論。
  • 準備 2–3 個要串接的帳號— 建議首輪就接 Gmail + Google Calendar + GitHub（開發者）或 Notion + Slack（知識工作者），否則記憶樹空轉，5 分鐘驗收會失敗。
  • 磁碟與網路— 記憶樹寫入本機 SQLite + Markdown，預留數百 MB；OAuth 與首輪擷取需要穩定網路。

完整相依性與從原始碼建置見官方儲存庫 docs/；一般使用者無需 clone 儲存庫。建議先在終端機跑一遍環境自檢，避免裝到一半才發現架構或 Homebrew 未就緒：

安裝前自檢（macOS 終端機） 
# 1. 系統與晶片（Apple Silicon 為 arm64）
sw_vers
uname -m

# 2. Homebrew 是否可用（走 brew 安裝時需要）
brew --version
brew doctor

# 3. 若計畫用本機 Ollama，先確認 11434 連接埠未被佔用
lsof -i :11434 || echo "連接埠 11434 空閒，可啟動 Ollama"

# 4. 磁碟空間（記憶樹 + 模型快取，建議 ≥5GB 可用）
df -h ~

三種安裝方式：官方套件、Homebrew、腳本

官方 README 明確指出：優先使用帶簽章的原生安裝套件或系統套件管理器，腳本安裝適合快速體驗，但供應鏈風險較高。下表依推薦順序排列。

方式適用指令 / 入口
官方安裝套件（推薦）macOS / Win / Linuxtinyhumans.ai/openhuman 或 GitHub Releases（DMG / MSI / deb / AppImage）
Homebrew（macOS / Linux）習慣終端機的 Mac 使用者brew tap tinyhumansai/core → brew install openhuman
一行腳本（示範用）快速試玩、CI 沙箱curl -fsSL …/install.sh | bash（可先 --dry-run）
方式 A · 官方 DMG（GUI + 終端機輔助） 
# 在瀏覽器開啟最新 Release（選與你晶片相符的 arm64 / x64）
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# 或官網下載頁
open "https://tinyhumans.ai/openhuman"

# 下載完成後，可用終端機掛載 DMG 並複製到「應用程式」（檔名以實際為準）
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# 若 macOS 攔截「無法驗證開發者」，移除隔離屬性後再開啟
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman
方式 B · Homebrew（2026 官方推薦，可重複升級） 
# 1. 新增官方 tap（只需執行一次）
brew tap tinyhumansai/core

# 2. 安裝（會拉取目前 stable 二進位檔）
brew install openhuman

# 3. 驗證是否進 PATH
which openhuman
openhuman --version

# 4. 啟動桌面版（CLI 會喚起 App，或從啟動台點 OpenHuman）
openhuman

# 5. 日後升級
brew update
brew upgrade openhuman

# 備選：不新增 core tap 時，部分文件寫法為
# brew install tinyhumansai/openhuman/openhuman
方式 C · npm 全域安裝（跨平台，需 Node ≥ 18） 
# 檢查 Node 版本
node -v

# 安裝 npm 套件（首次會下載對應平台原生二進位並校驗 SHA-256）
npm install -g openhuman

openhuman --version
openhuman
方式 D · Debian / Ubuntu · apt 簽章來源 
# 1. 匯入 GPG 並新增 apt 來源（官方 install 文件步驟）
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

# 2. 安裝並啟動
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version
方式 E · 一行腳本（先預覽再執行） 
# 1. 只下載腳本，不執行（建議先看內容）
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. 官方支援 dry-run 預覽（若腳本版本包含該參數）
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. 確認無誤後再安裝
bash /tmp/openhuman-install.sh

# macOS / Linux 一行版（等同上面第 3 步）
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  | bash

# Windows PowerShell：
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

安全提示

管線腳本（curl | bash）在任何專案上都有供應鏈風險。公司環境請走 簽章 DMG + MDM 分發，或內部鏡像 Homebrew tap；個人學習可用腳本，但勿在存放正式金鑰的機器上裸跑。

macOS 分步指令：從安裝到驗收（完整範例）

下面是一條可複製的終端機 + GUI 混合路徑：預設你用 Homebrew 安裝，並用 Anthropic API；若你走 DMG，可從「步驟 3」開始。每步後都附上如何確認成功。

步驟 1–2 · 安裝並確認行程 
brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# 確認 App 已在執行（應看到 OpenHuman 相關行程）
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep
步驟 3 ·（選用）先在本機拉起 Ollama，供「本機模型」選項使用 
# 安裝並背景啟動 Ollama（與 OpenHuman 分開，但可共用本機 GPU）
brew install ollama
brew services start ollama

# 拉取一個小模型做連通性測試（體積與名稱可按需替換）
ollama pull llama3.2

# API 探活：應回傳 JSON，含 models 清單
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo
步驟 4 · 在 OpenHuman 裡設定模型（GUI + 終端機輔助） 
# GUI：Settings → Models / Providers
#   - 雲端：貼上 Anthropic API Key（sk-ant-...）或 OpenAI Key
#   - 本機：Base URL 填 http://127.0.0.1:11434 ，模型選 llama3.2 等

# 勿把 Key 寫進 shell 歷史；若必須用環境變數做 CLI 測試，用暫時 export：
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# （輸入後 Enter，終端機不回顯；用完可 unset ANTHROPIC_API_KEY）

# 快速驗證 Anthropic 金鑰是否有效（與 OpenHuman 無關的獨立探針）
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo
步驟 5 · OAuth 整合（以 GUI 為主，無統一 CLI） 
# GUI：Connections / Integrations → 依序點選 Connect
#   建議順序：Gmail → Google Calendar → GitHub
# 瀏覽器完成 OAuth 後，回到 App 應顯示 Connected / Active

# 若公司代理導致回呼失敗，可先測 HTTPS 出站：
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5
步驟 6 · 等待同步並檢查記憶樹目錄 
# 保持 OpenHuman 執行 5–20 分鐘；可在選單列查看同步狀態
# 資料目錄因版本而異：先在 App「Settings → Data / Memory」查看路徑
# 常見在 Application Support 下，可用 find 粗查（可能需幾秒）：
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# 若已知記憶樹根目錄為 $MEMORY_DIR，列出最近 Markdown：
# MEMORY_DIR="…/memory"   # 替換為設定頁顯示的路徑
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# 抽查某個 .md 是否含真實主題列（郵件/會議/PR）
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"
步驟 7 · 對話驗收（在 App 聊天框輸入，示例如下） 
# 測試 1 — 日曆（需已接 Google Calendar）
「列出我今天的會議標題與開始時間，引用記憶樹裡的來源。」

# 測試 2 — GitHub（需已接 GitHub）
「我最近在哪個儲存庫有合併的 PR？給出儲存庫名與 PR 標題。」

# 失敗時：回答若明顯泛泛而談，回到步驟 6 確認 .md 是否產生

5 分鐘首次設定清單（依順序打勾）

若你更習慣 checklist 而非長指令，可按下面打勾；與上一節指令一一對應。計時從應用程式已開啟開始。

  1. 第 1 分鐘：選模型供應商— Settings 填入 Anthropic / OpenAI Key，或 Ollama Base URL http://127.0.0.1:11434；用 curl …/api/tags 或 Anthropic 探針確認金鑰有效。
  2. 第 2–3 分鐘：OAuth 連接— Connections 裡 Connect Gmail、Calendar、GitHub；瀏覽器授權後狀態為 Connected。
  3. 第 4 分鐘：觸發首輪同步— App 保持執行；find ~/Library/Application Support -iname '*openhuman*' 找到資料目錄後，確認有今日 .md。
  4. 第 5 分鐘：驗收對話— 用上一節「測試 1 / 2」提問；能引用具體事實即成功。

連接服務與驗證記憶樹

OpenHuman 的「數位分身」感來自記憶樹：第三方資料被規範化為 ≤3k token 的 Markdown 區塊，寫入本機 SQLite，並匯出為可用 Obsidian 開啟的 .md 檔案。驗證是否運作，不要只看 UI 綠燈，要看檔案是否落地：

  • 在應用程式內開啟 Memory Tree / 記憶目錄，確認有新檔案且時間戳為今天。
  • 用文字編輯器開啟任一 .md，應能看到郵件主旨、會議標題、PR 名稱等可核對的事實，而非空範本。
  • 選用：與 agentmemory 共用後端，讓 OpenHuman 與 Claude Code 共享持久記憶（進階）。
記憶樹 / SQLite 粗查（將 MEMORY_DIR 換成設定頁路徑） 
# 統計今日新增 Markdown 數量
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# 看最新 3 個片段修改時間
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# 若目錄旁有 SQLite（檔名因版本而異），可看表數量（需 sqlite3）
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

若你關心「和 ChatGPT 有什麼差別」：ChatGPT 的上下文在對話裡；OpenHuman 的上下文在你磁碟上可稽核的檔案裡——這也是它在 GitHub 走紅的原因。更多產品背景見五天體驗文。

和 OpenClaw 怎麼分工？

OpenHuman 管個人上下文（郵件、日曆、筆記）；OpenClaw 更偏 IM 編排與建置流水線。裝 OpenHuman 不會取代 Xcode CI；裝 OpenClaw 也不會自動讀懂你的收件匣。兩者可並存。

Mac 使用者進階：本機 vs 雲端 Mac 常駐

OpenHuman 設計為桌面常駐：合蓋休眠會拖慢同步。若你希望「下班電腦關機、分身仍在拉郵件摘要」，可以把執行個體放在始終在線的 Mac mini 上——例如 ZavCloud 雲端 Mac 獨享節點：真實 macOS、靜態 IP，便於 OAuth 回呼與長期背景任務。注意：OAuth 權杖與記憶樹檔案仍屬敏感資料，雲端部署要另外做磁碟加密、存取控制與備份策略，不要把個人 Gmail 直接丟在共享多租環境。

本機 Apple Silicon 上還可搭配 Ollama / MLX 做離線推論，與 OpenHuman 的「資料在本機」敘事一致；模型在本機、記憶在本機，只有整合同步走外網。若你做 iOS 開發，編碼仍建議用 Cursor / Claude Code，開工前問 OpenHuman「今天會議多嗎」——我們在Anthropic 與 Claude Code一文裡寫過類似的混搭工作流。

雲端 Mac 常駐（示意：SSH 登入後同樣 brew 安裝） 
# 登入你的 macOS 雲主機後
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# 無圖形介面時，部分版本支援僅跑同步引擎；以官方文件為準
# 建議：VNC/螢幕共享完成首次 OAuth，再把工作階段保持登入

# 防止合蓋休眠中斷同步（依機房策略選用）
sudo pmset -c sleep 0 displaysleep 0

常見問題排解

  • 安裝後無法開啟（macOS）— 系統設定 → 隱私權與安全性 → 仍要開啟；或右鍵 App → 打開。企業 MDM 可能攔截未公證套件，改走 Releases 裡的簽章 DMG。
  • OAuth 回呼失敗— 檢查代理/VPN、系統時間、瀏覽器是否攔截彈窗；公司網路可能封鎖 Composio 網域，需 IT 加白名單。
  • 記憶樹一直為空— 確認整合顯示 Connected；等待一個完整同步週期（約 20 分鐘）；查看官方 Issues 是否有你所在地區的 API 限流。
  • Agent 胡編— 記憶未寫入或模型未啟用「讀記憶」工具；縮小問題範圍，@ 指定記憶檔測試（若版本支援）。
  • brew install 找不到— 先 brew tap tinyhumansai/core 再 install；Intel Mac 請核對 Releases 是否提供對應架構。
排解指令速查 
# Homebrew 安裝失敗：清快取重試
brew update
brew cleanup
brew reinstall openhuman

# 應用程式當掉後查看 macOS 當機記錄
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama 已啟動但 OpenHuman 連不上
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# 完全解除安裝後重裝（brew 路徑）
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# 查看官方儲存庫最新 Issue（需 gh CLI）
gh issue list -R tinyhumansai/openhuman -L 5
進階 · 從原始碼執行（貢獻者 / 除錯，非 5 分鐘路徑） 
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# 僅 Web UI
pnpm dev
# 完整 Tauri 桌面開發
pnpm dev:app
# Rust 側檢查
cargo check -p openhuman --lib

FAQ

必須連網嗎？ 安裝、OAuth 與雲端模型要網；記憶檔案在本機。本機 Ollama 可弱網對話，但郵件/日曆同步仍需網。

免費嗎？ 客戶端開源（GPL-3.0）；模型 API 與部分連接器可能產生第三方費用，以你選的供應商帳單為準。

和 Cursor Rules / Claude Code 衝突嗎？ 不衝突。OpenHuman 不編輯你的儲存庫；編碼 Agent 不讀你的 Gmail。各管一層。

ZavCloud · 雲端 Mac

分身要 24 小時在線？用真 macOS 常駐節點

Mac mini M4 獨享執行個體：原生 macOS、靜態 IPv4——適合跑 OpenHuman 背景同步、Ollama 與 Xcode 同一台可稽核機器。

查看方案與定價
Cloud Mac線上租用 Mac mini