OpenHuman 指南

安装教程

OpenHuman 安装指南：Windows / macOS / Linux 全部安装方式

2026-05-26约 10 分钟阅读

OpenHuman 是一个开源的桌面端个人 AI 智能助手，支持 macOS、Windows 和 Linux。官方提供了 4 种安装方式，按安全性和便利性推荐如下：

⚡ 安装优先级推荐

  1. 系统包管理器（Homebrew / apt / AUR）— 最安全，走系统签名链
  2. 官网下载安装包（DMG / EXE / AppImage）— 最简单，一键安装
  3. 一键脚本（curl | bash / irm | iex）— 方便但需注意安全验证
  4. 从源码编译 — 开发者专属，可体验最新特性

系统要求

  • 操作系统： macOS 12+ / Windows 10+ / Linux Kernel 5.x+
  • 内存： 建议 4GB+，处理大量邮件或仓库建议 16GB+
  • 硬盘： 至少 2GB 可用空间

首次启动时，系统可能会请求权限（macOS 的 Accessibility、Windows 的通知权限等），可以在 设置 → Automation & Channels 中随时调整。

方式一：系统包管理器安装（推荐）

macOS — Homebrew

一条命令安装，通过 Homebrew 的签名链验证，最安全的方式：

brew tap tinyhumansai/openhuman
brew install openhuman

Linux（Debian/Ubuntu）— apt 仓库

添加官方的签名 apt 仓库后安装，走系统包管理器的签名链：

# 安装依赖
sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates

# 添加 GPG 签名密钥
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg

# 添加软件源
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list

# 安装
sudo apt-get update
sudo apt-get install -y openhuman

此方式会自动处理依赖关系，后续更新也通过 sudo apt-get update && sudo apt-get upgrade 完成。

Linux（Arch Linux）— AUR

仓库中提供了 openhuman-bin AUR recipe，Arch 用户可通过 yay 安装：

yay -S openhuman-bin

方式二：官网下载安装包

访问 tinyhumans.ai/openhuman，选择你的平台下载：

macOS（DMG）

  • 下载 .dmg 文件
  • 双击打开，将 OpenHuman 图标拖入 Applications 文件夹
  • 首次打开需在 系统设置 → 隐私与安全性 中点击"仍要打开"
  • 同时支持 Apple Silicon（M1/M2/M3/M4）和 Intel 芯片

Windows（MSI）

  • 下载 .msi 安装包（签名版本）
  • 双击运行，安装向导会自动完成（约 1-2 分钟）
  • 如果系统提示安全警告，点击"仍要运行"
  • 安装完成后桌面会显示 OpenHuman 图标

Linux（DEB / AppImage）

  • DEB： Debian/Ubuntu 用户可直接下载 .deb 包安装
  • AppImage： 通用格式，下载后 chmod +x 即可运行

⚠ 注意： AppImage 在 Wayland 下（以及 Arch 衍生版）可能启动崩溃，见 GitHub Issue #2463。优先使用 DEB 包可避免此问题。

所有安装包均可在 GitHub Releases 页面下载到历史版本。

方式三：一键脚本安装

macOS / Linux

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

⚠ 安全说明： 这些脚本从 raw.githubusercontent.com 实时提供，没有单独的签名验证。如果你担心脚本被篡改，推荐使用上面的系统包管理器方式（走系统签名链验证）。

目前在 PR #2620 中正在为脚本添加 GPG 签名验证，后续将支持 install.sh.asc 验证流程。

方式四：从源码编译

适合开发者或希望体验最新特性的用户。从 GitHub 克隆后编译：

前置依赖

  • Git
  • Node.js 24+
  • pnpm 10.10.0（npm install -g pnpm@10.10.0）
  • Rust 1.93.0（含 rustfmt + clippy）
  • CMake、Ninja、ripgrep
  • 各平台的 Tauri 构建依赖

编译步骤

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
pnpm dev          # Web UI 开发模式
# 或用：pnpm --filter openhuman-app dev:app  # 桌面应用模式

首次编译约 10-15 分钟（需下载 Tauri/CEF 源码）。更详细的开发者指南见 CONTRIBUTING.md。

安装后首次启动

安装完成后，启动 OpenHuman 会进入引导流程：

  1. 登录： 首次无代码会显示"Sign in! Let's Cook"页面，支持多种登录方式（社交账号等）。也可以点击 Advanced 使用自定义后端 RPC URL。
  2. 连接集成： 通过 OAuth 一键连接 Gmail、GitHub、Notion 等账户
  3. 自动同步： Auto-fetch 每 20 分钟自动拉取数据到记忆系统
  4. 设置语音： 如需要，配置麦克风和语音输出

🔐 注意：登录 ≠ 授权访问你的数据

登录只是验证身份，并不会自动授予 OpenHuman 访问你任何数据的权限。每个第三方集成需要你单独通过 OAuth 授权。OpenHuman 是 本地优先 的——你的记忆树、Markdown 仓库、工作区配置和运行时状态都存储在你的机器上。

一键脚本 vs 系统包管理器 vs 安装包，怎么选？

对比项系统包管理器下载安装包一键脚本
安全验证✅ 签名链✅ MSI/DMG 签名⚠️ 无签名（改进中）
自动更新✅ autoremove手动下载手动重跑
便利性需添加源✅ 最方便✅ 一条命令

常见问题

安装后打不开

检查系统版本是否满足要求（Windows 10+ / macOS 12+ / Linux kernel 5.x+）。如果满足，尝试重新下载安装包。macOS 用户注意需要在"隐私与安全性"中允许打开。

apt 添加仓库失败

确认已安装 gnupg2 和 ca-certificates。如果 GPG 密钥导入失败，可以手动下载 DEB 包安装。

AppImage 启动崩溃

在 Wayland 下或 Arch 衍生版中可能出现。解决方案：使用 DEB 包安装或设置环境变量（见 GitHub Issue #2463）。

如何卸载？

  • Homebrew： brew uninstall openhuman 然后 brew untap tinyhumansai/openhuman
  • DEB： sudo apt-get remove openhuman
  • Windows： 控制面板 → 程序和功能 → 卸载 OpenHuman
  • 脚本安装： 手动删除安装目录（默认 ~/.openhuman 或 %LOCALAPPDATA%\\openhuman）
← 返回教程列表