> 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 上的辅助功能权限，以及语音热键所需的输入监控权限）。你可以随时在 **设置**.

***

## 1. 下载并安装

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

## 2. 登录

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

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

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

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

当 Gmail 导入完成后（首次自动抓取会在二十分钟内发生），可以尝试以下提示：

**简报**

* “我需要了解过去 12 小时内的什么内容？”
* “我有什么待办？”

**跨来源查询**

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

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

***

## 4. 打开 Obsidian 仓库

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

***

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

现在代理已经具备记忆和模型，产品的其余部分就是为它提供更多入口：

* [**从集成自动抓取**](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md) - 从 **设置**连接更多数据源；调度器每二十分钟会将新数据拉取到你的树中。
* [**原生语音**](/openhuman/zh/gong-neng/native-tools/voice.md) - 按住说话式听写和 TTS 回复，让你可以通过说话而不是打字与 OpenHuman 交流。

## 加入社区

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

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