Linux 知识库

Appearance

OpenHuman 安装与快速上手 ​

概述 ​

OpenHuman 的安装过程非常简洁，相比其他需要"先 BYO API Key、再调一堆环境变量"的开源项目，安装体验差距明显。装完不到 3 分钟即可运行。

系统要求 ​

  • macOS：M 系列芯片或 Intel 芯片
  • Windows：Windows 10 及以上
  • Linux：通过命令行脚本安装

安装方式 ​

方式一：命令行安装（推荐） ​

bash
# macOS / Linux
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

方式二：官网下载 ​

访问 tinyhumans.ai/openhuman 下载适用于你操作系统的 DMG 或 EXE 安装包。

五步上手指南 ​

第一步：安装并启动 ​

使用上面的命令行或官网下载完成安装，启动 OpenHuman。

连接完成后，你将看到桌面吉祥物出现——一个常驻桌面的动画角色。

第二步：连接 Gmail ​

不要一上来连接 10 个集成。 先只连接 Gmail 这一个服务：

  1. 点击授权按钮，完成 OAuth 授权
  2. 让 OpenHuman 先熟悉你的邮箱数据

第三步：观察 Memory Tree 同步 ​

连接 Gmail 后，让它运行 1-2 个小时把邮箱过一遍：

  • 在 Intelligence 页面查看同步进度
  • 观察 Memory Tree 如何从零开始构建摘要树
  • 感受"AI 逐步认识你"的过程

这是最直观感受 OpenHuman 核心能力的方式。

第四步：用 Obsidian 查看 AI 大脑 ​

这是 OpenHuman 最独特的一步——路径为 ~/.openhuman/wiki/：

text
~/.openhuman/wiki/
├── sources/         # 按来源组织
├── topics/          # 按主题组织
├── daily/           # 每日摘要
└── index.md         # 总入口

用 Obsidian 打开这个目录，你将看到：

  • AI 如何理解你的邮件
  • 如何归纳每个人和每个项目
  • 信息之间的关联关系

这些 Markdown 文件可读可改，相当于你可以直接编辑 AI 的记忆。

第五步（可选）：试一次会议代理 ​

挑选一个低风险的内部会议（不要是与客户的会议）：

  1. 把 Google Meet 链接丢给吉祥物
  2. 观察它如何以参会者身份加入
  3. 会后检查生成的会议纪要质量

第五步（可选）：开启本地 AI ​

如果在意隐私，可以在模型路由设置中开启 Local AI 开关：

  • 底层走 Ollama
  • 将 embedding 和摘要树构建移到本地
  • 聊天和语音仍走云端
  • 核心知识库的生成完全离线
  • M 系列 Mac 运行效果较好

谁还不适合用 OpenHuman ​

在决定使用前，诚实地评估以下情况：

情况建议
完全无法接受任何数据走云考虑 Ollama + LocalAI 方案
团队/企业部署需求官方标注 Cloud Deploy 为 Early Beta，做好踩坑准备
中文场景为主要需求UI 为英文，底层 LLM 可中文聊天但界面未本地化
不爱折腾Early Beta 每周迭代，可能遇到 bug、断线重连等问题

相关文档：产品概述 | MemoryTree 记忆系统

最后更新：2026-05-22