返回内容中心
教程

OpenHuman 小白使用手册

2026/6/10

🧠 OpenHuman 小白使用手册（超详细版）

适合完全零基础的用户，手把手教你从安装到精通
来源：https://tinyhumans.gitbook.io/openhuman

📖 目录

一、OpenHuman 到底是什么？

OpenHuman 是一个有"面孔"、有"记忆"的桌面 AI 助手。

它和其他 AI 助手最大的区别：

| 普通 AI 助手 | OpenHuman |
|------------|-----------|
| 每次聊天都失忆 | ✅ 有长期记忆，读过你的邮件、文档、聊天记录 |
| 只能聊天 | ✅ 能参加会议、管理日程、操作 GitHub |
| 没有个性 | ✅ 有桌面吉祥物，会说话、会动、会参加视频会议 |
| 需要配置 API | ✅ 一个订阅搞定所有模型 |

简单说：OpenHuman 是一个"真正了解你"的 AI。

二、与 OpenClaw / Hermes 有什么不同？

| | OpenClaw 🦞 | Hermes Agent ☤ | OpenHuman 🧠 |
|------|:---:|:---:|:---:|
| 使用方式 | 终端 + 聊天 App | 终端 + 聊天 App | 桌面 App（有界面） |
| 难度 | ⚠️ 需要一点终端经验 | ⚠️ 需要一点终端经验 | ✅ 下载即用，无需命令 |
| 记忆 | 依赖技能 | 自我学习 | 记忆树 + Obsidian 知识库 |
| 集成 | 自己配置 | 自己配置 | 118+ 一键连接 |
| 特色 | 多通道消息 | 自我学习循环 | 桌面吉祥物 + 会议代理 |

选哪个？

  • 想要桌面 App 点点点就用 → OpenHuman
  • 想要终端里用或用 Telegram 聊就用 → Hermes Agent
  • 想要在20+ 聊天 App 上用就用 → OpenClaw

三、准备工作

系统要求

| 系统 | 支持情况 |
|------|---------|
| macOS | ✅ Intel 和 Apple Silicon |
| Windows | ✅ x64 和 ARM64 |
| Linux | ✅ x64（AppImage） |
| 内存 | 至少 4GB（推荐 8GB+） |

你需要准备

| 物品 | 说明 |
|------|------|
| 一台电脑 | Mac、Windows、Linux 都行 |
| 网络 | 能访问互联网 |
| 基本上就是下载安装，不需要配置 API | 一个账号解决所有 |

四、下载与安装

最简单的方式：官网下载

打开 https://tinyhumans.ai/openhuman

点击下载按钮，选择你的操作系统：

  • macOS → 下载 .dmg 文件
  • Windows → 下载 .exe 安装程序
  • Linux → 下载 .AppImage 文件

终端安装（如果喜欢命令行）

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

安装后的权限设置

macOS 用户需要授予权限：

  1. 辅助功能权限（Accessibility）— 让吉祥物显示在桌面上
  2. 输入监控权限（Input Monitoring）— 让 AI 能读取你的输入
  3. 摄像头/麦克风权限 — 用于会议代理和语音

系统会自动弹出提示，点击"允许"即可。

五、登录账号

打开 OpenHuman 后会看到登录页面。

注册方式

支持多种方式登录：

  • Google 账号
  • GitHub 账号
  • Discord 账号
  • 邮箱注册

选择一种方式，按提示完成注册即可。一个账号 = 一个订阅，所有模型都能用。

六、第一次使用（快速上手）

第 1 步：打开 App

双击桌面图标打开 OpenHuman，你会看到一个干净的聊天界面。

第 2 步：问第一个问题

直接在输入框里打字，比如：

"你好！"

或者更实际一点：

"现在几点了？"

"帮我看看今天的天气"

AI 会回复你。就这么简单，不需要任何配置。

第 3 步：试一个跨来源查询

OpenHuman 强大的地方是能同时访问多个数据源：

"帮我总结一下我最近的邮件，并告诉我今天有什么会议"

（但要做到这一步，需要先连接你的账号——见下一节）

七、连接你的各种账号（一键 OAuth）

这是 OpenHuman 最强大的功能之一——一键连接 118+ 个服务。

支持的连接

| 分类 | 服务 |
|------|------|
| 📧 邮箱 | Gmail |
| 📅 日历 | Google Calendar |
| ☁️ 云盘 | Google Drive |
| 💻 代码 | GitHub、GitLab |
| 💬 通讯 | Slack、Discord、Telegram |
| 📝 笔记 | Notion |
| 📋 项目管理 | Linear、Jira、Asana |
| 💳 支付 | Stripe |
| 🤝 CRM | Salesforce、HubSpot |
| 还有更多... | 118+ 个服务 |

如何连接

  1. 点击界面左侧的 "Integrations"（集成）图标
  2. 找到你想连接的服务
  3. 点击 "Connect"（连接）
  4. 在弹出的 OAuth 页面授权

全程不需要输入密码或 API Key，就像用 Google 登录一样简单。

自动获取数据（Auto-fetch）

连接后，OpenHuman 每 20 分钟会自动拉取新数据：

  • 新邮件 → 存入记忆
  • 新消息 → 存入记忆
  • 新代码提交 → 存入记忆
  • 新日程 → 存入记忆

你不需要做任何事，AI 会自动了解你的最新动态。

八、记忆系统——AI 永远不会忘记你

记忆树（Memory Tree）

OpenHuman 把收集到的信息整理成"记忆树"，有三层：

🌳 全局树（Global Tree）—— 你的整体画像
  └── 🌿 主题树（Topic Tree）—— 按主题分类
       └── 🍃 源树（Source Tree）—— 按来源分类

每个信息块被压缩为 ≤3000 token 的 Markdown 片段，存储在本地 SQLite 数据库中。

Obsidian 知识库

除了 SQLite，所有记忆还会以 .md 文件的形式保存在：

<工作目录>/wiki/

这意味着你可以用 Obsidian（一个免费的笔记软件）打开、浏览和编辑 AI 的记忆！

操作步骤：

  1. 在 OpenHuman 界面点击 "View vault in Obsidian"
  2. Obsidian 会自动打开，显示完整的知识库
  3. 你可以手动编辑任何笔记
  4. AI 下次读取时会使用你编辑后的版本

如何用好记忆系统？

连接越多服务，记忆越丰富。 建议至少连接：

  1. Gmail（邮件）
  2. Google Calendar（日程）
  3. GitHub（代码工作）
  4. Slack 或 Discord（聊天）

这样 AI 就能全面了解你的工作和生活。

九、桌面吉祥物——AI 有了"面孔"

吉祥物是什么？

OpenHuman 的桌面有一个可爱的动画角色，它是 AI 的"面孔"。

吉祥物能做什么？

  • 🗣️ 说话并口型同步——文字转语音时嘴巴会动
  • 👀 对环境做出反应——你打字时它会看着输入框
  • 📹 参加 Google Meet——作为真实参与者加入会议
  • 🧠 后台思考——即使你不在打字，它也在默默工作
  • 😴 做梦——可选功能，在空闲时整理记忆

会议代理（最重要功能！）

AI 可以作为一个真实参与者加入你的 Google Meet 会议！

能做的事情：

  1. 实时转写——把会议内容转成文字
  2. 回答问题——"刚才张三提到的截止日期是什么时候？"
  3. 调用工具——"帮我查一下这个客户的信息"
  4. 提供建议——"这个问题我建议..."

吉祥物的脸会显示在摄像头画面中，其他参会者能看到它在听。

如何设置？

在设置中开启 "Meeting Agent" 功能，然后：

  1. 在 Google Calendar 创建会议
  2. 把 OpenHuman 作为参会者添加
  3. 会议开始时它会自动加入

十、模型路由——自动选最合适的模型

自动选择

OpenHuman 会根据任务类型自动选择最合适的模型：

| 你的需求 | 写提示时加 | 使用的模型类型 |
|---------|-----------|--------------|
| 复杂推理（数学、编程） | hint:reasoning | 最强推理模型 |
| 快速回答 | hint:fast | 轻量快速模型 |
| 看图片 | hint:vision | 多模态模型 |
| 摘要总结 | hint:summarize | 摘要优化模型 |
| 写代码 | hint:code | 编程模型 |

你不需要手动切换模型，系统会自动分配。

本地 AI（可选）

如果你想让一些任务在本地运行（保护隐私）：

# 配置文件
[model_routing]
local_ai = true

通过 Ollama 或 LM Studio 运行本地模型，适合：

  • Embedding（文本向量化）
  • 摘要
  • 后台循环任务

默认关闭，需要主动开启。

十一、语音功能

语音输入（STT）

  • 支持快捷键启动语音输入
  • 流式转写（边说话边显示文字）
  • 有幻觉过滤器（过滤错误转写）

语音输出（TTS）

  • 多种语音风格可选
  • 吉祥物口型同步
  • Google Meet 中发声

如何使用

在聊天输入框旁边找到麦克风图标，点击后开始说话。

十二、子意识循环（Subconscious Loop）

这是什么？

OpenHuman 有一个后台心跳，即使你没有在跟它聊天，它也在默默工作：

每 N 秒 → 检查是否有需要做的事
         ↓
    ├── 没事 → 继续等待
    ├── 有用户任务 → 自动执行
    └── 有系统任务 → 自动执行

它会做什么？

  • 检查是否有新邮件需要处理
  • 看看有没有到时间的定时任务
  • 整理和更新记忆
  • 如果有异常情况，主动弹出通知

你可以让它自动处理一些事情，比如：

"如果有重要的新邮件，通知我"

之后它就会在后台监控，有新邮件时主动提醒你。

十三、隐私与安全

数据归谁？

数据归你，完全归你。

  • 🔒 本地存储——记忆树存在你电脑的 SQLite 里
  • 🔑 OAuth 令牌——存储在后端代理，不会泄露
  • 🚫 不训练——你的数据不会用来训练模型
  • 🗝️ 系统密钥链——敏感信息存在系统钥匙串里

安全措施

  • 技能在沙箱中运行
  • 可以完全离线使用（部分功能）
  • 连接的服务可以随时断开

十四、常见问题排查

Q：安装后打不开？

macOS： 去"系统设置"→"隐私与安全性"→"仍要打开"
Windows： 可能被杀毒软件拦截，添加信任即可

Q：登录失败？

  1. 检查网络连接
  2. 尝试换个登录方式（比如用 Google 不行就试试 GitHub）
  3. 去官网确认服务状态

Q：吉祥物不显示？

# 检查权限设置
系统设置 → 隐私 → 辅助功能 → OpenHuman ✅
系统设置 → 隐私 → 输入监控 → OpenHuman ✅

Q：连接服务失败？

断开重连试试：

  1. OpenHuman 左侧 → Integrations
  2. 找到出问题的服务 → Disconnect
  3. 重新 Connect

Q：AI 回答不准确？

可能原因：

  • 刚安装，记忆还不够丰富 → 多连接几个服务，等自动同步
  • 用 hint:reasoning 提示使用更强的推理模型

Q：如何退出？

点击窗口左上角的关闭按钮。可以在后台继续运行（子意识循环会继续工作）。

十五、实用场景示例

场景 1：全能个人助手

  1. 下载安装 OpenHuman
  2. 连接 Gmail、Google Calendar、GitHub、Slack
  3. 等待 20 分钟（自动同步数据）
  4. 问它：

"今天有什么重要的邮件和会议？"

AI 会读取你的邮件和日历，给出完整的每日简报。

场景 2：会议小助手

  1. 开启 Meeting Agent
  2. 在 Google Calendar 创建会议
  3. 开始会议
  4. 随时问它：

"刚才客户说了什么需求？"
"帮我查一下这个客户的合同信息"

场景 3：代码审查自动通知

  1. 连接 GitHub
  2. 开启自动获取
  3. 设置通知：

"如果有新的 PR 需要我审查，通知我"

之后有新的 Pull Request，AI 会自动提醒你。

场景 4：个人知识库

  1. 连接 Gmail、Notion、Google Drive
  2. AI 会自动建立你的记忆树
  3. 打开 Obsidian 查看知识库
  4. 问它：

"我去年做的那个项目的关键信息是什么？"

还想了解更多？

  • 📘 官方文档：https://tinyhumans.gitbook.io/openhuman
  • 💬 Discord 社区：https://discord.tinyhumans.ai
  • 🐱 GitHub：https://github.com/tinyhumansai/openhuman
  • 🌐 官网下载：https://tinyhumans.ai/openhuman

本手册由简川工作室基于 OpenHuman 官方文档整理，适合零基础用户阅读。
最后更新：2026-05-23