> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gai-lan/getting-started.md).

# 快速开始

本页面将引导你完成 OpenHuman 的安装、应用内引导流程，并运行你的第一个请求。

OpenHuman 是依据 GNU GPL3 许可证开源的。代码库位于 [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman).

{% hint style="info" %}
**想要特定结果？** 如果你来这里是为了完成某件具体事情（设置私人助手、运行本地模型、修复损坏的安装，或迁移到新机器）， [指南](/openhuman/zh/zhi-nan/guides.md) 部分提供了按任务划分的详细步骤。
{% endhint %}

***

## 系统要求

OpenHuman 可运行于 **macOS、Windows 和 Linux** 桌面系统。建议至少 4 GB 内存；如果你打算摄取非常大的邮箱或代码仓库，或在同一台机器上运行 [本地模型](/openhuman/zh/gong-neng/model-routing/local-ai.md) ，则建议 16 GB 以上。

### 权限

首次启动 OpenHuman 时，操作系统会提示授予应用所需的权限（macOS 上的辅助功能、语音热键所需的输入监控，如果你计划使用 [会议代理](/openhuman/zh/gong-neng/mascot/meeting-agents.md)，还需要摄像头/麦克风权限）。你可随时在 **设置**.

***

## 1. 下载并安装

从以下位置获取 OpenHuman 桌面应用 <http://tinyhumans.ai/openhuman> ，或者通过你平台的软件包管理器安装。安装完成后打开应用。

## 2. 登录

第一个界面是 **“登录！开工吧”**。提供多种登录方式，包括社交登录。如果你运行自己的后端，还有一个 **高级** 面板可用于将应用指向自定义的核心 RPC URL；大多数用户可以忽略它。

{% hint style="info" %}
**没有永久绑定。** 登录并不会让 OpenHuman 持续访问任何内容。所有第三方访问都需要在下方步骤中针对每个集成进行明确的 OAuth 授权。
{% endhint %}

{% hint style="warning" %}
**了解哪些在本地，哪些由托管。** 你的记忆树数据库、Markdown 保管库、工作区配置和本地运行时状态都保留在你的机器上。默认设置仍会使用 OpenHuman 托管的服务来完成登录、模型路由、受管集成的 OAuth/工具调用以及网页搜索代理。如果你想使用自己的模型、搜索或 Composio 凭据，请使用自定义设置路径。某些托管功能和实时集成触发仍需要受管后端。
{% endhint %}

## 3. 运行你的第一个请求

在 Gmail 被摄取完成后（首次自动抓取会在二十分钟内发生），尝试如下提示：

**简报**

* “过去 12 小时里我需要知道什么？”
* “我有哪些待办？”

**跨来源查询**

* “总结一下我今天错过了什么。”
* “本周有哪些关键决策？”
* “从我最近的对话中提取行动项。”
* “Sarah 就项目在邮件和聊天中说了什么？”

OpenHuman 会自动为每个任务选择合适的模型。参见 [自动模型路由](/openhuman/zh/gong-neng/model-routing.md).

***

## 4. 打开 Obsidian 保管库

记忆选项卡中有一个 **在 Obsidian 中查看保管库** 按钮。点击它可打开 `<workspace>/wiki/` 于 [Obsidian](https://obsidian.md)。你可以浏览代理的摘要，放入自己的笔记，甚至手动建立链接——代理会在下一次摄取时拾取你的编辑。参见 [Obsidian 风格记忆](/openhuman/zh/gong-neng/obsidian-wiki.md).

***

## 5. 让吉祥物做更多事

现在代理已经有了记忆和模型，产品的其余部分就是给它更多“舞台”：

* [**会议代理**](/openhuman/zh/gong-neng/mascot/meeting-agents.md) - 丢入一个 Google Meet 链接，吉祥物就会作为真实参与者加入：它会聆听、把笔记写入记忆树、在通话中发言，并实时使用工具。
* [**从集成自动抓取**](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md) - 从 **设置**连接更多来源；调度器每二十分钟会将新数据拉入你的记忆树。
* [**原生语音**](/openhuman/zh/gong-neng/native-tools/voice.md) - 按键说话听写和 TTS 回复，让你可以直接与 OpenHuman 对话，而不是打字。
* [**潜意识循环**](/openhuman/zh/gong-neng/subconscious.md) - 让吉祥物在你离开时继续处理常驻任务。

## 加入社区

OpenHuman 仍处于早期测试阶段。此阶段的反馈和贡献会带来实质性的影响。

* **GitHub：** [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman)
* **Discord：** [discord.tinyhumans.ai](https://discord.tinyhumans.ai)