> 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/zhi-nan/guides/personal-assistant.md).

# 创建我的个人 AI 助手

**目标：** 一个可用的助手，能记住你世界中的一些内容，用你喜欢的风格回复，并且绝不会在未经你允许的情况下采取任何现实世界中的行动。

这是“从这里开始”指南。它除了你已经下载了应用之外，不假设任何前提。

***

## 前提条件

* 已在 macOS、Windows 或 Linux 上安装 OpenHuman。如果你还没安装，请先 [入门指南](/openhuman/zh/gai-lan/getting-started.md) 先安装，然后再回来。
* 4 GB+ 内存（如果你打算连接非常大的邮箱或运行一个 [本地模型](/openhuman/zh/zhi-nan/guides/local-model.md)).
* 用于登录的账户（支持社交登录）。
* 可选：一个你希望助手了解的账户（通常第一个是 Gmail）。

## 隐私影响

* 登录 **不** 不会授予对任何内容的持续访问权限。每个集成都需要单独、明确的 OAuth 授权，你之后都可以撤销。
* 你的记忆（本地数据库和 Markdown 保管库）会被创建 **在你的机器上**。原始源数据不会存放在 OpenHuman 后端。
* 默认情况下，聊天/推理会通过 OpenHuman 托管的 [模型路由器](/openhuman/zh/gong-neng/model-routing.md)。如果你想改为在设备上推理，请参见 [将 OpenHuman 与本地模型一起使用](/openhuman/zh/zhi-nan/guides/local-model.md).
* 完整细节： [保护敏感数据的隐私](/openhuman/zh/zhi-nan/guides/privacy-sensitive-data.md).

***

## 步骤

### 1. 登录

启动应用。第一个界面是 **“登录！开动吧”**。选择一种登录方式。这里有一个 **Advanced** 用于指向自定义核心的面板；大多数人会忽略它。

### 2. 选择 AI 的运行方式

登录后你会进入一个 **运行时选择**:

* **云端**：一键即可，由托管模型路由器处理推理。这是让助手快速可用的最快路径。
* **自定义**：由你自己逐步选择推理提供方、语音、集成（OAuth）、网页搜索和嵌入。

如果你不确定，就选 **云端**。你之后可以在 **设置**.

### 3. 给它一些可记住的内容

没有记忆的助手就只是个聊天机器人。至少连接一个来源，这样它才有可用的上下文：

* 打开 **设置** 并连接一个集成（Gmail 是常见的起点）。每次连接都是一次点击即可完成的 OAuth 授权。
* 连接后， [自动抓取](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md) 会开始把数据拉取到你的 [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md) 中，按计划进行（第一次 Gmail 同步通常会在大约二十分钟内到来）。

### 4. 设定你的边界

打开 **设置 → 代理 → 代理访问**。这决定助手能在多大程度上自行行动：

| 级别             | 含义                                                  |
| -------------- | --------------------------------------------------- |
| **只读**         | 助手可以观察并回答，但绝不会采取行动（不发送、不写文件、不执行命令）。                 |
| **受监督** *（默认）* | 它可以行动，但任何会改变状态、涉及网络、安装或破坏性的操作都需要 **暂存，等待你的批准** 的那个。 |
| **完整**         | 常规操作会自动执行；网络/安装/破坏性操作仍会询问。                          |

保持开启 **受监督** ，除非你有理由不这样做。未经你同意，聊天中不会发生任何会产生外部影响的操作。这就是 [审批门槛](/openhuman/zh/gong-neng/approval-gate.md)，而且默认开启。

### 5. 塑造它的个性（可选）

助手如何说话和行为由一个可编辑的提示词定义，称为 **`SOUL.md`** （它的使命和价值观存放在一个配套的 **`IDENTITY.md`**）里。你不必修改这些内容（它们带有合理的默认值），但你可以：

* 在 **设置 → 个性**.
* 通过 **大脑** 页面编辑其行为（底部栏中间凸起的按钮， `/brain`），那里存放着记忆、目标和智能。

OpenHuman 也会 **学习** 你在一段时间内如何纠正它，从而学习到持久的偏好。参见 [个性化与自学习](/openhuman/zh/gong-neng/personalization.md).

### 6. 运行你的第一个真实请求

一旦某个来源已被导入，试试：

* “过去 12 小时里我需要知道什么？”
* “有什么在等我处理？”
* “总结我今天错过了什么。”

***

## 成功检查

当以下情况都成立时，你就拥有一个可用的助手： **全部** 都满足：

* [ ] 应用已登录（你已越过欢迎界面，进入聊天/主页视图）。
* [ ] 至少有一个集成显示为 **已连接** ，在设置中。
* [ ] 一个简报提示（“有什么在等我处理？”）返回的是来自你真实数据的内容，而不是泛泛的答案。
* [ ] 打开 **记忆** 选项卡会显示摘要出现（连接来源后，给它一个自动获取周期，最多约 20 分钟）。
* [ ] 当你让它执行某个会产生外部影响的操作时（例如“起草并发送一封邮件”），你会看到一个 **审批请求卡片** 出现在聊天框上方，而不是它静默执行。

## 常见故障

| 症状              | 含义                         | 修复方法                                                          |
| --------------- | -------------------------- | ------------------------------------------------------------- |
| 登录后又回到欢迎界面      | OAuth 回调没有到达应用             | 按照 [登录故障排查](/openhuman/zh/gai-lan/troubleshooting-sign-in.md) |
| 已连接来源，但记忆仍为空    | 第一次自动获取还没运行，或者 OAuth 作用域太窄 | 等待一个周期（约 20 分钟）；在设置中重新检查连接                                    |
| 助手回答很泛泛，忽略了你的数据 | 它在没有调用记忆的情况下作答             | 再问一次，并明确引用来源（“来自我的邮件……”）；确认该来源已连接                             |
| 它执行了一个你没预料到的操作  | 自主级别可能被设置为 **完整**          | 设置 **设置 → 代理 → 代理访问** 改回 **受监督**                              |

## 恢复

* **快速重置边界：** 如果助手做得太多，把级别降到 **只读** ，在 Agent 访问中。它会在下一轮生效，并立即阻止所有行动。
* **你连接的任何内容都不是永久的：** 可在设置中撤销任何集成；已经进入你本地记忆的片段会保留（它们属于你），下一次同步就会停止拉取该来源。
* **如果应用本身无法启动，** 请参见 [从失败的安装中恢复](/openhuman/zh/zhi-nan/guides/recover-failed-installation.md)。你的配置默认会被保留。

***

## 下一步

* [将 OpenHuman 与本地模型一起使用](/openhuman/zh/zhi-nan/guides/local-model.md)：将推理保留在设备端。
* [将 OpenHuman 连接到 Obsidian](/openhuman/zh/zhi-nan/guides/connect-obsidian.md)：手动读取并编辑记忆。
* [保护敏感数据的隐私](/openhuman/zh/zhi-nan/guides/privacy-sensitive-data.md)：准确了解哪些内容会离开你的设备。