如何安装 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文档推荐的原生安装包路径这些路径使用操作系统的包管理器或原生安装器自带签名/完整性校验macOSHomebrew Caskbrew install --cask openhumanLinuxDebian/Ubuntu发行版 .deb# 先下载 OpenHuman_version_amd64.debarm64 主机换成 arm64 # 然后 sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.debapt 会替你解析运行期依赖。文档提示AppImage 在 Wayland 下可能启动崩溃、缺libgbm.so.1等系统库或在 Arch 系发行版上报sharun: Interpreter not found!所以在 Debian/Ubuntu 上用上面的.deb路径可以避开这些失败模式。LinuxArch仓库内置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 # WindowsPowerShell irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex在 Debian/Ubuntu 上install.sh会优先解析最新的.deb并用 apt-get 安装使运行依赖交给 apt 处理设置环境变量OPENHUMAN_INSTALLER_LINUX_PACKAGEappimage可强制走 AppImage 路径。安装完成后打开应用一次进入下一步。登录Sign in 界面首次启动后的第一个界面是Sign in! Lets Cook提供多种登录方式含社交登录。界面里还有一个Advanced面板用于把应用指向你自己的 core RPC URL——只有自托管后端时才需要普通用户可以忽略。文档强调一点登录本身不会授予 OpenHuman 对任何第三方服务的持续访问权每个集成都需要单独的、显式的 OAuth 授权之后可以随时在Connections页面撤销。选运行时Cloud 还是 Custom登录之后会遇到一次运行时选择runtime choiceCloud一键完成由 OpenHuman 托管的模型路由器处理推理。这是走到能用的助手最快的路径。Custom自己逐一选择推理 provider、语音、集成 OAuth、网页搜索和 embeddings。文档给出的建议是不确定就选Cloud之后再通过Settings随时改动任何一项。默认设置下登录、模型路由、托管集成的 OAuth/工具调用和网页搜索代理都走 OpenHuman 托管服务而你的 Memory Tree 数据库、Markdown vault、workspace 配置和本地运行状态都留在本机。如果想把推理移到本地文档在 使用本地模型 中单独说明前提安装 Ollama8 GB 以上内存这里不展开。连接 Gmail助手没有记忆就只是一个聊天机器人所以第一步要给它数据源打开Settings找到 Gmail 集成点击Connect浏览器窗口打开 OAuth 页面完成一次一键式授权文档说明托管路径下无需手工配置 API key连接成功后该集成状态显示为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?Whats waiting on me?跨来源查询类的示例还有 Summarize what I missed today. 等。OpenHuman 会为每个任务自动挑选合适的模型无需手动指定。结果验证怎么算跑通了文档给出的成功判据是以下条件全部成立应用已登录过了欢迎屏进入聊天/主页视图至少一个集成在 Settings 中显示为connected简报提示词如 whats waiting on me?返回的内容来自你的真实数据而不是通用回答打开Memory标签页能看到摘要在出现——连接数据源后给一个自动抓取周期最多约 20 分钟当要求助手做有外部影响的操作例如起草并发送一封邮件时聊天框上方出现Approval Request 卡片而不是它静默执行。第 5 条对应 Agent access 的自主档位Settings → Agents → Agent access默认是Supervised——助手可以行动但任何状态变更、网络、安装或破坏性操作都会先挂起等你批准。文档建议没有特殊理由就保持 SupervisedRead-only 完全禁止行动Full 会让常规操作自动执行网络/安装/破坏性操作仍会询问。出问题时对照这几条文档列出的常见失败与对应处理现象含义处理方式登录后回到欢迎屏OAuth 回调没有到达应用按 Troubleshooting Sign-In 排查检查后端可达性、deep-link 回调openhuman://auth?...、Windows 下openhuman://协议注册等连了数据源但 Memory 一直是空的第一次自动抓取 tick 还没跑或 OAuth scope 太窄等一个周期约 20 分钟再在 Settings 里复查连接助手回答很泛、不引用你的数据它回答时没有召回记忆重新提问并显式引用来源from my email…确认来源处于 connected 状态它执行了你没预期的操作自主档位可能设成了Full把Settings → Agents → Agent access调回Supervised补充两点文档明确的边界撤销某个集成不会删除已经入库的本地分块那是你的数据只是下一个同步 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考