企业官网建设流程全解析

如何安装 OpenHuman 并完成首次使用：选运行时、连接 Gmail 并跑通第一个简报请求

【免费下载链接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.项目地址: https://gitcode.com/GitHub_Trending/op/openhuman

这篇文章的任务是把一个刚装好（或还没装）的 OpenHuman 走到"能用"的状态：在 macOS、Windows 或 Linux 桌面端完成安装，通过首次登录，在运行时选择里挑一个推理路径，连接 Gmail，等第一个自动抓取周期落库，然后发出第一个简报请求并确认它真的读到了你的邮件数据，而不是返回泛泛的通用回答。

准备条件

按文档给出的要求：

• 操作系统：macOS、Windows 或 Linux 桌面端；
• 内存：建议 4 GB 以上；如果打算接入非常大的邮箱、或者在同一台机器上跑本地模型，建议 16 GB 以上；
• 一个可以登录 OpenHuman 的账号（支持社交登录）；
• 一个希望助手了解的数据源，Gmail 是最常见的第一选择。

首次启动时系统会弹出权限请求（macOS 的辅助功能权限、语音热键所需的输入监控等），这些权限之后可以随时在Settings里查看和调整。

安装 OpenHuman

文档推荐的原生安装包路径（这些路径使用操作系统的包管理器或原生安装器，自带签名/完整性校验）：

macOS（Homebrew Cask）：

brew install --cask openhuman

Linux（Debian/Ubuntu，发行版 .deb）：

# 先下载 OpenHuman_<version>_amd64.deb（arm64 主机换成 arm64）， # 然后： sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.deb

apt 会替你解析运行期依赖。文档提示：AppImage 在 Wayland 下可能启动崩溃、缺libgbm.so.1等系统库，或在 Arch 系发行版上报sharun: Interpreter not found!，所以在 Debian/Ubuntu 上用上面的.deb路径可以避开这些失败模式。

Linux（Arch）：仓库内置openhuman-binAUR 配方，见 packages/arch/openhuman-bin；发布后可以用yay -S openhuman-bin安装。

Windows：从最新 release 下载签名的.msi并运行。

备选：脚本安装（未签名校验路径）。安装脚本直接从raw.githubusercontent.com拉取执行，文档明确标注它目前没有独立的签名可供执行前校验，能走原生包路径时优先走原生包。确实要用脚本时：

# macOS 或 Linux x64 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

在 Debian/Ubuntu 上，install.sh会优先解析最新的.deb并用 apt-get 安装，使运行依赖交给 apt 处理；设置环境变量OPENHUMAN_INSTALLER_LINUX_PACKAGE=appimage可强制走 AppImage 路径。

安装完成后打开应用一次，进入下一步。

登录：Sign in 界面

首次启动后的第一个界面是"Sign in! Let's Cook"，提供多种登录方式（含社交登录）。界面里还有一个Advanced面板，用于把应用指向你自己的 core RPC URL——只有自托管后端时才需要，普通用户可以忽略。

文档强调一点：登录本身不会授予 OpenHuman 对任何第三方服务的持续访问权；每个集成都需要单独的、显式的 OAuth 授权，之后可以随时在Connections页面撤销。

选运行时：Cloud 还是 Custom

登录之后会遇到一次运行时选择（runtime choice）：

• Cloud：一键完成，由 OpenHuman 托管的模型路由器处理推理。这是走到"能用的助手"最快的路径。
• Custom：自己逐一选择推理 provider、语音、集成 OAuth、网页搜索和 embeddings。

文档给出的建议是：不确定就选Cloud，之后再通过Settings随时改动任何一项。

默认设置下，登录、模型路由、托管集成的 OAuth/工具调用和网页搜索代理都走 OpenHuman 托管服务；而你的 Memory Tree 数据库、Markdown vault、workspace 配置和本地运行状态都留在本机。如果想把推理移到本地，文档在 使用本地模型 中单独说明（前提：安装 Ollama，8 GB 以上内存），这里不展开。

连接 Gmail

助手没有记忆就只是一个聊天机器人，所以第一步要给它数据源：

1. 打开Settings，找到 Gmail 集成，点击Connect；
2. 浏览器窗口打开 OAuth 页面，完成一次一键式授权（文档说明托管路径下无需手工配置 API key）；
3. 连接成功后，该集成状态显示为Connected，即"活跃并在同步"。

连接完成后，自动抓取（auto-fetch）调度器开始把数据拉入 Memory Tree：一个全局调度每 20 分钟 tick 一次，遍历所有活跃连接，对到了同步间隔的源调用其 native provider 的同步逻辑。Gmail 有 native ingest 路径，会按"拉取新消息 → 规范化 → 入库分块"的流程写入本地 SQLite。文档给出的时间预期：连接后第一次 Gmail 自动抓取 tick 大约会在 20 分钟内到达（首次使用的页面表述为 within twenty minutes）。

跑第一个简报请求

等 Gmail 入库后（即等完第一个自动抓取周期），在聊天里发简报类请求。文档给出的示例提示词：

• "What do I need to know from the last 12 hours?"
• "What's waiting on me?"

跨来源查询类的示例还有 "Summarize what I missed today." 等。OpenHuman 会为每个任务自动挑选合适的模型，无需手动指定。

结果验证：怎么算"跑通了"

文档给出的成功判据是以下条件全部成立：

• 应用已登录（过了欢迎屏，进入聊天/主页视图）；
• 至少一个集成在 Settings 中显示为connected；
• 简报提示词（如 "what's waiting on me?"）返回的内容来自你的真实数据，而不是通用回答；
• 打开Memory标签页能看到摘要在出现——连接数据源后给一个自动抓取周期，最多约 20 分钟；
• 当要求助手做有外部影响的操作（例如"起草并发送一封邮件"）时，聊天框上方出现Approval Request 卡片，而不是它静默执行。

第 5 条对应 Agent access 的自主档位：Settings → Agents → Agent access默认是Supervised——助手可以行动，但任何状态变更、网络、安装或破坏性操作都会先挂起等你批准。文档建议没有特殊理由就保持 Supervised；Read-only 完全禁止行动，Full 会让常规操作自动执行（网络/安装/破坏性操作仍会询问）。

出问题时对照这几条

文档列出的常见失败与对应处理：

补充两点文档明确的边界：撤销某个集成不会删除已经入库的本地分块（那是你的数据），只是下一个同步 tick 停止拉取该来源；如果应用本身无法启动，配置默认保留，可参考 Recover from a failed installation。

下一步

完成以上验证后，按文档给出的延伸方向：连接更多集成让 20 分钟调度持续拉取新数据（Settings里连接即可）；在Memory标签页用View vault in Obsidian打开<workspace>/wiki/查看并编辑助手的摘要——agent 会在下一次 ingest 时拾取你的修改；或者切换到本地模型路线，把部分推理留在本机。

【免费下载链接】openhumanOpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.项目地址: https://gitcode.com/GitHub_Trending/op/openhuman