这个教程解决什么问题

读完这篇你能做到：装好 OpenHuman、接入第一批服务、验证自动同步正常工作，并按需把模型切到全本地运行。OpenHuman 的安装设计哲学是「无终端、无配置优先」——大部分过程是点击，需要动手的部分本文标清楚了。

第一步：安装应用

三个平台的安装方式：

macOS / Linux（脚本安装）：

curl -fsSL <官方 install.sh 地址> | bash

Windows（PowerShell）：

irm <官方 install.ps1 地址> | iex

图形化安装（全平台）：从官网下载 DMG（macOS）或 EXE（Windows）安装包，双击安装。这是最稳的路线——脚本安装适合喜欢命令行的用户，安装包适合所有人。

技术栈交代一下背景：OpenHuman 是 Rust + Tauri 的桌面应用（不是 Electron，包体和内存占用小一个量级），后端要求 Rust 1.93.0+、构建用 Node.js 24+ 的 pnpm monorepo——不过这些只有从源码构建才需要关心，普通用户直接用安装包即可。

第二步：连接你的服务

安装完成打开应用，第一件事是接入服务。OpenHuman 支持 118+ 第三方服务，全部走 OAuth 一键授权——不需要手动创建 API key，不需要逛插件市场。

首批接入建议按「信息密度」排序：

优先接入理由
Gmail / 邮箱信息密度最高的个人数据源
Calendar 日历AI 理解「你最近在忙什么」的骨架
GitHub开发者的工作主线
Slack / 即时通讯团队上下文
Notion / Drive文档与知识库

隐私提示：OAuth 授权时看清楚权限范围，按最小必要原则勾选。接入的数据存在本机 SQLite，不上传任何服务器——但授权范围本身决定了「能被读进来的东西」的边界。

第三步：等一轮自动同步，验证记忆树

接入完成后不用做任何事——OpenHuman 的自动抓取（auto-fetch）每 20 分钟从所有活跃连接拉取新数据。第一次使用建议等一轮完整的同步周期（或手动触发一次抓取），然后验证：

  1. 记忆树有内容了——打开记忆视图，能看到按来源/主题/日期折叠的摘要结构
  2. 问一个只有上下文才能答的问题——比如「我最近一周在忙什么」，它应该能基于刚同步的数据给出具体回答，而不是让你先自我介绍
  3. Obsidian 落盘确认——如果配置了 vault 目录，打开看 .md 文件是否生成

第三步是 OpenHuman 区别于所有黑盒助手的关键：记忆树落盘为 Markdown 文件，你在 Obsidian 里可以直接读、改、删、建链接——这个能力在知识管理工作流篇专门展开。

第四步（可选）：切换本地模型

OpenHuman 默认走云端模型自动路由（推理任务给前沿模型、快速任务给便宜模型、视觉任务给视觉模型——一个订阅搞定）。如果你要求数据完全不出本机，接入本地运行时：

Ollama 路线（推荐，安装见本站 Ollama 教程）：

# 拉一个适合 Agent 任务的模型
ollama pull qwen3:32b

# 确认 OpenAI 兼容端点在跑
curl http://127.0.0.1:11434/v1/models

然后在 OpenHuman 设置里选择本地运行时——支持 Ollama、LM Studio、MLX（Apple Silicon） 和任何 OpenAI 兼容端点，填本地地址即可。

隐私模式（终极本地化）：设置里的单一开关，由 Rust 核心强制执行——打开后结构上阻断所有云模型调用，只允许设备端运行。这不是「配置项承诺」，是代码层面的硬约束，这也是开源本地方案的信任基础。

本地模型的取舍要想清楚：隐私拉满，但推理质量与前沿云模型有差距，且吃本机显存（32B 级别模型需要 24G+ 显存，选型见本地模型显存测算）。务实的混合路线：隐私模式关掉，但把敏感类任务习惯性走本地、通用任务走云端路由。

避坑清单

坑现象处理
脚本安装失败管道命令报权限或网络错误换 DMG/EXE 安装包路线，最稳；脚本路线留给命令行熟手
OAuth 全选允许授权范围超出实际需要按最小必要原则勾选——权限范围决定「能被读进来的东西」的边界
同步没完成就验收第一轮 20 分钟没跑完就断定「没反应」等完整一轮同步或手动触发抓取，再验证记忆树
本地模型显存拍脑袋32B 模型塞进 8GB 显存的机器32B（4bit）约需 20~24GB 显存或统一内存；16GB 显存跑 14B 是体验底线
隐私模式当装饰开了隐私模式又抱怨云端任务变笨隐私模式是结构断云，开了就只有本地模型——要云端能力就按敏感度走混合分级

常见问题 FAQ

Q：必须从源码构建吗？

不用。Rust 1.93.0+、Node.js 24+ 这些前置条件只服务于源码构建，普通用户下载安装包即可，开发环境一个都不用装。

Q：装完第一句问什么？

问一个「只有了解你才答得上」的问题，比如「我最近一周在忙什么」。答得具体，说明同步和记忆树已经在工作；让你先自我介绍，说明数据还没同步到位——这是最直接的验收信号。

Q：首批接多少个服务合适？

3~5 个核心服务（邮箱、日历、GitHub、即时通讯、文档）足够跑通全部工作流。服务随时可以增量接入，先跑顺再扩——比一口气接二十个、回头记不清授权过什么强得多。

Q：订阅之外还有别的成本吗？

云端路由消耗订阅额度，TokenJuice 压缩负责把工具输出的 token 开销压下来；切到本地模型后模型费用为零，代价是电费、显存占用和推理质量折损。

安装后第一周的节奏

  • Day 1：接入 3~5 个核心服务，等同步，问几个上下文问题验证
  • Day 2~3：让它干一件真实小事（总结本周邮件、查某个项目的历史讨论），感受「不用交代背景」的差别
  • Day 4~5：把第一个重复性流程描述给它，让它生成工作流
  • 一周后：评估要不要上本地模型、要不要让它代你开会

OpenHuman 的记忆是复利资产——用得越久，20 分钟一次的同步积累出的上下文越厚，「它懂你」的体感是线性变强的。装完就让它开始攒。