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;终端可用官方 install.sh,主力机建议先看脚本或只用安装包。现在:装好见到登录页。

为什么系统拦截?

答:macOS Gatekeeper / Windows SmartScreen 会拦未商店分发应用。在「隐私与安全性」选仍要打开,并只用官网包对照 Release 版本。现在:通过拦截后启动。

登录以后还要配什么?

答:OAuth 登录只证明你是谁、开通订阅;默认对话与集成代理仍可能走托管后端。还要:① 选模型;② 在 Integrations 逐个 Connect。现在:登录 → 模型 → 集成,先别聊天。

模型怎么选?要买 API Key 吗?

答:不必须。BYOK(Bring Your Own Key) 是自备云厂商密钥、按量付费;也可用订阅 + TokenJuice 压缩上下文省 token;Ollama 走本地,M 系 Mac 建议 24GB+ 内存更稳。密钥勿进 Git。发一句「你好」验收。现在:定一种计费方式并测通模型。

为什么要单独授权集成?

答:登录与连 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 裸机 · 秒级开通
开通 →