OpenHuman 首次启动配置

装完 OpenHuman 后，从启动到能用大约 30 分钟。本文以「连接 Gmail + 第一次提问」为示范，带你跑通整个流程。其他集成的配置思路完全相同，掌握这一篇就够了。

整体流程概览

1. 启动应用 + 登录 / 跳过登录
2. 选择 LLM 提供商（云端 API 或本地 Ollama）
3. 连接第一个集成（推荐 Gmail）
4. 等待首次 Auto-fetch 同步完成
5. 第一次对话提问
6. 在 Obsidian 浏览你的 Memory Tree

步骤 1：启动 + 登录

双击桌面图标启动 OpenHuman。首次启动会看到欢迎页面，问你是否要登录 OpenHuman 账户。

登录 vs 跳过 — 哪个选项好？

步骤 2：选择 LLM 提供商

OpenHuman 自己不内置 LLM，需要你接入。Setup 流程里会让你选择 LLM 来源：

选项 A：云端 API（OpenAI / Claude / Gemini / APINebula 中转）

速度快、质量稳定，但需要 API Key 与稳定的国际网络。配置步骤：

1. 选择 OpenAI / Anthropic / Google / APINebula 中转 任一
2. 粘贴你的 API Key（OpenHuman 不会上传 key 到任何服务器，仅本地加密存储）
3. 选择默认模型：
   • OpenAI：推荐 GPT-4o-mini（便宜）或 GPT-4o（质量好）
   • Anthropic：推荐 Claude 3.5 Haiku（便宜快）或 Claude 3.5 Sonnet（质量好）
   • Google：推荐 Gemini 2.0 Flash（最便宜）
4. OpenHuman 会用 TokenJuice 压缩上下文，实际成本通常比直连便宜很多

选项 B：本地模型（Ollama）

免费、完全离线，但响应慢、模型质量受电脑配置限制。配置步骤：

1. 先在 ollama.ai 下载并装好 Ollama
2. 启动 Ollama（默认监听 localhost:11434）
3. 根据你的电脑配置拉一个合适的模型：

   # 8 GB RAM：选 3B 参数模型
   ollama pull llama3.2:3b
   
   # 16 GB RAM：选 7B-14B
   ollama pull llama3.1:8b
   ollama pull qwen2.5:14b
   
   # 32+ GB RAM：可以选 32B-70B
   ollama pull qwen2.5:32b
   ollama pull llama3.1:70b

4. 在 OpenHuman 设置里选 Ollama，填入 endpoint（默认 http://localhost:11434）

选项 C：混合策略（推荐）

OpenHuman 支持 Model Routing 模型路由。你可以同时配置多个 LLM：

• 简单任务（总结、提取） → 跑本地 Ollama（免费快速）
• 复杂推理（多步骤、长上下文） → 跑云端 Claude / GPT-4o（质量好）
• 视觉任务（看图） → 跑专门视觉模型

设置位置：Settings → Model Routing。可以按任务类型自动分配。

步骤 3：连接第一个集成（Gmail 示范）

在 OpenHuman 主界面找到「Integrations」或「Sources」面板，看到 100+ 集成卡片。点击 Gmail。

OAuth 授权流程

1. OpenHuman 会打开你的默认浏览器，跳到 Google 的 OAuth 授权页面
2. 用你想接入的 Gmail 账户登录
3. 授权列表里通常包含：
   • 读取邮件元数据（发件人、主题、收件时间、标签）
   • 读取邮件正文
   • 可选：读取附件、读取联系人
4. 默认是只读权限——OpenHuman 不能替你发邮件（除非你后续单独授予写权限）
5. 授权完成后浏览器会跳回 OpenHuman，显示 "Gmail connected ✅"

步骤 4：等待首次同步

授权后 OpenHuman 立即开始 Auto-fetch 自动拉取：

• 第一次会拉取最近 3-6 个月的邮件（具体看你的设置）
• 每封邮件会被 TokenJuice 压缩、按主题归类、生成 Memory Tree 节点
• 邮件量大（5 万+）的话首次同步可能要 15-20 分钟，期间 CPU / 网络会繁忙
• 之后每 20 分钟自动增量同步一次

同步过程中你可以继续操作 OpenHuman 的其他功能，不必干等。但建议第一次不要立刻关掉应用，让它把基线数据建好。

首次同步进度怎么看

OpenHuman 主界面顶部通常有一个 sync 状态指示器：

• 🟡 同步中：圆圈旋转，下方显示进度（如 1234 / 5678）
• 🟢 同步完成：变绿色对勾，显示最后一次同步时间
• 🔴 同步失败：变红色，点击查看错误信息

步骤 5：第一次提问

同步完成后，主界面的对话框就能用了。试几个示范提问：

检索类（OpenHuman 最擅长）

• "上周谁给我发过关于 X 项目的邮件？"
• "上个月我和张三的所有邮件主题列一下"
• "找出我所有未回复的客户邮件"
• "最近 7 天提到了'季度报告'的邮件有哪些"

总结类

• "总结一下今天收到的所有邮件"
• "我收件箱里最重要的 5 件事是什么？"
• "上周哪些邮件提到了截止日期？"
• "我这个月收到的所有合同/账单类邮件，按金额列出"

分析类

• "我最近一个月给谁发的邮件最多？"
• "我每天平均收多少封邮件？"
• "我邮件里出现频率最高的关键词 / 主题是什么？"

跨应用问题（连接多个集成后）

连接了多个集成（如 Gmail + Slack + GitHub + Notion）后，可以问跨应用问题：

• "上周 Slack 里张三说的截止日是什么时候，对应的 Notion 任务进度如何？"
• "过去 30 天有哪个 GitHub PR 是为了解决某封客户邮件提到的 bug？"

步骤 6：在 Obsidian 浏览 Memory Tree

OpenHuman 的 Memory Tree 是真正的 Markdown 文件（不是数据库黑盒）。你可以用 Obsidian 直接打开浏览：

1. 下载并安装 Obsidian（免费）
2. 启动 Obsidian → 点 Open folder as vault
3. 选择 OpenHuman 的 vault 目录：
   • macOS：~/Library/Application Support/OpenHuman/vault
   • Windows：%APPDATA%\OpenHuman\vault
   • Linux：~/.local/share/OpenHuman/vault
4. Obsidian 会加载这个目录，你会看到一棵 Markdown 文件树：邮件主题、人物、项目等被 OpenHuman 自动组织成节点

意义：你的数据永远在你这。即便 OpenHuman 倒闭了，你还有这堆 Markdown 文件。这才是「本地优先」的真正含义。

常见首启问题

OpenHuman 启动后界面卡死怎么办？

有可能是首次 Memory Tree 索引建立时占用资源过大。建议：

1. 等 5-10 分钟，可能是后台在处理大量数据
2. 如果仍卡死，关闭 OpenHuman，重新启动
3. 仍不行，删除 vault 目录下的 .openhuman.lock 文件后重试

OAuth 授权页打不开 / 卡住

常见原因：

• 默认浏览器没正确设置（OpenHuman 调用系统默认浏览器）
• 科学上网不稳定（Google OAuth 服务器在境外）
• 浏览器拦截了 localhost 回调（OAuth 完成后会跳回 http://localhost:xxx）

排查：手动复制 OpenHuman 显示的授权 URL 到浏览器，确认能打开。

同步速度极慢怎么办？

首次同步慢有几个原因：

• 邮件量过大（5 万封以上）—— 正常，耐心等
• 网络不稳 —— 检查 VPN，必要时重新触发同步
• 电脑性能差 —— RAM 4 GB 以下处理 token 压缩会慢

OpenHuman 设置里可以限制首次拉取的日期范围（如只拉最近 30 天），加快初始化。

怎么让 OpenHuman 不上传任何数据？

OpenHuman 默认是本地优先的。要确保完全离线，做几件事：

1. 步骤 1 选择"跳过"，不注册 OpenHuman 云账户
2. 步骤 2 选择 Ollama 本地模型（不用云端 API）
3. 检查 Settings → Privacy → 关闭所有可选的 telemetry / 错误上报
4. 用网络抓包（Little Snitch / Charles）验证 OpenHuman 没向意外的地址发请求

恭喜，你已经能用 OpenHuman 了！

到这一步你已经完成了 OpenHuman 的完整初始化。接下来推荐：

• 每天用 OpenHuman 处理几个真实问题，让它的 Memory Tree 持续生长
• 添加更多集成（Notion、Slack、GitHub 等）扩展 OpenHuman 的视野
• 研究 OpenHuman 的核心概念：Memory Tree、TokenJuice、Model Routing
• 关注 OpenHuman GitHub Release，每周都有新版本