AI Agent

OpenHuman 小白怎麼開始:
2026 從安裝到連接數據源保姆問答

nuzcloud 編輯部 2026-05-28
導讀摘要

第一次聽說 OpenHuman,看到 OAuth、BYOK、Memory Tree 會發懵——其實先跑通最小路徑就行:裝桌面應用 → 登入 → 選模型 → 連 1~2 個數據源 → 等記憶入庫 → 問一句能驗收的話。下文用「你問、教程答」帶你走完(核對至 2026-05-28)。

3
最小跑通路徑
安裝 · 登入 · 連源
20
auto-fetch 週期
首輪同步請耐心等
本機優先
記憶在機
≠ 完全離線
⚠️同名專案:本文指 tinyhumansai/openhuman,安裝請認準 tinyhumans.ai/openhuman

OAuth、BYOK、Memory Tree 第一次見會暈——先跑通最小路徑即可,不必讀完架構文件。

我到底在安裝什麼?

答:不是網站也不是 SDK,而是桌面應用 + 本機 Agent:用 OAuth 連 Gmail、Notion、GitHub 等,把資料寫進本機記憶樹Markdown vault(Obsidian 可讀)。記憶在本機,但聊天與部分 OAuth 仍可能走雲端——本機優先 ≠ 完全離線現在你要做:確認是 tinyhumans 版再安裝。

安裝前要準備什麼?下載哪個才對?

答:需要日常用機、穩定網路、數 GB 磁碟,並接受 Gmail 等 OAuth 讀取權限。新手優先從官網下載 DMG / EXE / AppImage;終端機可用官方 install.sh,主力機建議先看過腳本或只用安裝包,避免直接 pipe 遠端腳本。現在你要做:裝好並看到登入頁。

為什麼系統會攔截?

答:macOS Gatekeeper、Windows SmartScreen 會攔未上架商店的應用。到「隱私與安全性」選仍要開啟,且只用官網安裝包並對照 Release 版本號。現在你要做:通過攔截後啟動應用。

登入以後還要配什麼?

答:OAuth 登入只證明你是誰、開通訂閱;預設對話與整合代理仍可能走託管後端。還要:① 選模型;② 在 Integrations 逐個 Connect。現在你要做:登入 → 模型 → 整合,先別急著聊天。

模型怎麼選?一定要自己買 API Key 嗎?

答:不必然。BYOK(Bring Your Own Key) 是自備雲端廠商金鑰、按量付費;也可用訂閱 + TokenJuice 壓縮上下文省 token;Ollama 走本機,M 系列 Mac 建議 24GB+ 記憶體較穩。金鑰勿進 Git。發一句「你好」驗收。現在你要做:定一種計費方式並測通模型。

為什麼連 Gmail、Notion 還要單獨授權?

答:登入與連 Gmail 是兩次 OAuth,權限範圍不同、可隨時斷開。118+ 連接器裡,auto-fetch 自動入庫目前以 Gmail、Notion、Slack 等為準,其餘以 GitBook 為準。現在你要做:先連 Gmail + 一個你熟悉的來源。

記憶什麼時候會出現?

答:活躍整合約每 20 分鐘 拉取入庫,首輪常需等滿一個週期。驗收:寄一封標題獨特的測試郵件 → 等 20~40 分鐘 → 在 vault 搜標題 → 問 Agent 能否引用細節。現在你要做:按這四步驗收。

第一個任務怎麼跑?失敗了怎麼辦?

答:任務選唯讀總結類,如「總結 Gmail 裡某專案最近三封郵件」。失敗按層自問:應用/版本 → 登入與模型 → 整合是否 Expired → 是否等夠 20 分鐘、vault 有無新 md → 是否連錯帳號;再查 GitHub Issues,費用分清訂閱、BYOK 與 Ollama 資源。現在你要做:跑通一次唯讀問答再擴整合。

在 Mac mini 上長期跑 OpenHuman

記憶庫與 auto-fetch 適合靜音長開:Mac mini M4 統一記憶體有利 Ollama,macOS 的 SIP、FileVault 更適合放個人上下文,待機約 4W。若要 Agent 7×24 累積記憶,Mac mini M4 是高性價比起點——現在即可了解配置。

最小路徑速記
  • 官網 DMG 安裝 → 過 Gatekeeper
  • 登入 + 選模型(訂閱 / BYOK / Ollama)
  • 連 Gmail 等 → 等 20 分鐘 → 查 vault 驗收
  • 第一個唯讀總結任務通過,再擴整合
nuzcloud · Mac 雲伺服器

用 Mac mini 搭建 OpenHuman 常開工作台

專屬 Mac mini M4,適合本機 Agent、Ollama 與記憶庫 7×24 運行。秒級開通,隨時擴容。

Mac 雲伺服器 M4 裸機 · 秒級開通
開通 →