OpenHuman 下载与安装

基于 OpenHuman v0.54.x 2026-05-20 更新

OpenHuman 官方提供三种安装方式：一键脚本（推荐）、桌面安装包（适合不信任脚本的用户）、源码构建（适合开发者）。99% 的用户用前两种之一即可。

📦 唯一的官方下载源

所有 OpenHuman 安装包与脚本只应来自官方域名 tinyhumans.ai 或 GitHub Releases。不要从第三方网站、镜像站或网盘下载，避免被植入恶意代码。

方式一：一键安装脚本（推荐）

这是 OpenHuman 官方推荐的方式。脚本会自动检测你的系统架构、下载正确的二进制、装到默认目录。

macOS / Linux 一键安装

打开 Terminal（终端），粘贴执行：

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

脚本会自动完成：

检测系统（macOS / Linux）与架构（x64 / ARM64）
下载对应的安装包到 ~/Downloads
解压并复制到：
- macOS：/Applications/OpenHuman.app
- Linux：~/.local/bin/openhuman 与 ~/.local/share/applications/
在 GUI 启动器里注册（Linux 上可能需要重新登录系统才能在菜单看到）

Windows 一键安装

用管理员身份打开 PowerShell（右键 PowerShell 图标 → 以管理员身份运行），粘贴执行：

irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

脚本会下载 .msi 包并自动安装到 %LOCALAPPDATA%\Programs\OpenHuman。

⚠️ Windows Defender 误报

由于 Tauri 应用还不普及，Windows Defender 偶尔会误报。如果遇到拦截：

点 More info / 更多信息
点 Run anyway / 仍要运行
如果不信任脚本，可改用方式二从 GitHub Releases 直接下载官方签名的 .msi

方式二：从 GitHub Releases 下载安装包

对一键脚本不放心，或者脚本下载失败时，可以直接从 GitHub Releases 手动下载：

👉 github.com/tinyhumansai/openhuman/releases

选择对应平台的最新版本安装包：

平台	文件名格式	说明
macOS Intel	`OpenHuman_{version}_x64.dmg`	2020 年之前的 Mac
macOS Apple Silicon	`OpenHuman_{version}_aarch64.dmg`	M1/M2/M3/M4
Windows	`OpenHuman_{version}_x64_en-US.msi`	Win 10+
Linux DEB	`open-human_{version}_amd64.deb`	Debian / Ubuntu
Linux RPM	`open-human-{version}-1.x86_64.rpm`	Fedora / RHEL / CentOS
Linux AppImage	`open-human_{version}_amd64.AppImage`	通用，免安装

macOS 详细安装步骤

下载 .dmg 文件后，双击挂载
把 OpenHuman 图标拖入"Applications"文件夹
从 Launchpad 或 Finder Applications 启动 OpenHuman
首次启动 macOS Gatekeeper 会拦截 → 打开"系统设置 → 隐私与安全性" → 找到 OpenHuman → 点"仍要打开"
首次运行授权"网络访问"、"文件读取"等权限（按需勾选）

macOS 提示「OpenHuman.app 已损坏」

Apple 没给 OpenHuman 的开发者签 notarization 的话会有这个误报。临时方案（仅在你信任安装包来源时执行）：

xattr -cr /Applications/OpenHuman.app

这会清除 quarantine 属性，应用就能正常启动。建议从官方 GitHub Releases 直接下载，确保未被篡改。

Windows 详细安装步骤

下载 .msi 文件
双击启动安装向导
跟随向导选择安装路径（建议保持默认）
完成后从"开始菜单"或桌面快捷方式启动 OpenHuman

Windows 启动报 auth-profiles.lock 错误

这是 v0.54.0 之前版本的已知 bug（参考 GitHub Issue #1475），已修复。请确认你的版本是 v0.54.0 或更新。如果仍出现：

关闭 OpenHuman 应用
删除 %APPDATA%\OpenHuman\.openhuman 整个目录
重新启动 OpenHuman，会重新初始化

Linux 详细安装步骤

Debian / Ubuntu（DEB 包）

sudo dpkg -i open-human_*.deb
sudo apt-get install -f  # 解决缺失依赖

Fedora / RHEL / CentOS（RPM 包）

sudo rpm -i open-human-*.rpm
# 或者
sudo dnf install open-human-*.rpm

通用（AppImage 免安装）

chmod +x open-human_*.AppImage
./open-human_*.AppImage

Arch / Manjaro

暂无官方 AUR 包。从源码构建或者用 AppImage。社区可能维护非官方 AUR 包，请自行甄别可信度。

Linux 启动报 libwebkit2gtk 缺失

Tauri 依赖 WebKit。按你的发行版安装：

# Ubuntu / Debian
sudo apt install libwebkit2gtk-4.1-0 libsoup-3.0-0

# Fedora
sudo dnf install webkit2gtk4.1

# Arch / Manjaro
sudo pacman -S webkit2gtk-4.1

方式三：从源码构建（开发者）

如果你想审计源码、修改 OpenHuman、或者贡献 PR：

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
pnpm install
pnpm run tauri build

构建前需要预装：

Git
Node.js 24+
pnpm 10.10.0
Rust 1.93.0+（含 rustfmt + clippy）
CMake、Ninja、ripgrep
平台桌面构建前置依赖（详见仓库 CONTRIBUTING.md）

💡 加速 Rust 依赖下载

国内用户构建时 Rust 依赖下载可能很慢。建议配置 cargo 国内镜像（如 RsProxy / 中科大）：

# ~/.cargo/config.toml
[source.crates-io]
replace-with = 'rsproxy'

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

验证安装成功

启动 OpenHuman 后，应该看到欢迎页面，要求你：

注册 / 登录 OpenHuman 账户（用于云同步选项，开源版可跳过）
选择 LLM 提供商（OpenAI / Claude / Gemini / Ollama）
连接第一个集成（最常见是 Gmail）
等待首次 Memory Tree 同步（5-20 分钟）

如果你看到这个流程 → 安装成功。下一步去首次启动配置看详细的初始化步骤。

常见安装问题

下载速度极慢怎么办？

OpenHuman 的官方包托管在 GitHub Releases，国内访问可能很慢。三个加速方案：

用 Steam++（Watt Toolkit）加速 GitHub 域名
使用 GitHub 镜像：把 github.com 替换为 ghproxy.com（注意第三方镜像存在被篡改风险）
科学上网（最稳）

安装包签名校验

对安全要求高的用户，可对下载的安装包做 SHA-256 校验。OpenHuman 在 GitHub Releases 页提供每个文件的 checksum：

# macOS / Linux
shasum -a 256 OpenHuman_0.54.0_aarch64.dmg

# Windows (PowerShell)
Get-FileHash OpenHuman_0.54.0_x64_en-US.msi -Algorithm SHA256

把输出的 hash 与官方 release 页面上的 SHA256SUMS 文件对比，一致即说明包未被篡改。

能不能装在 USB 移动设备上？

理论可以，但不推荐：

macOS：把 .app 拖到 USB 即可，但启动会很慢
Windows / Linux：AppImage 是单文件，可以放 USB 直接运行
但 Memory Tree 数据可能很快超出 USB 容量，且 USB 读写速度严重影响 Auto-fetch 性能

多用户共享一台机器，怎么装？

OpenHuman 默认按用户隔离。每个 Windows / macOS 用户独立装，互不干扰。Linux 上系统级安装（DEB / RPM）后，每个用户的 Memory Tree 单独存储在 ~/.local/share/OpenHuman 下。

卸载 OpenHuman

macOS 卸载

# 删除应用本身
rm -rf /Applications/OpenHuman.app

# 删除用户数据（如果想清干净）
rm -rf ~/Library/Application\ Support/OpenHuman
rm -rf ~/Library/Caches/com.tinyhumans.openhuman
rm -rf ~/Library/Preferences/com.tinyhumans.openhuman.plist

Windows 卸载

方法一：从"控制面板 → 程序与功能"找到 OpenHuman，点卸载。

方法二：从"开始菜单 → 设置 → 应用"找到 OpenHuman 卸载。

清理用户数据：

rmdir /s "%APPDATA%\OpenHuman"
rmdir /s "%LOCALAPPDATA%\OpenHuman"

Linux 卸载

# DEB
sudo apt remove open-human

# RPM
sudo rpm -e open-human
# 或 sudo dnf remove open-human

# AppImage
rm /path/to/open-human_*.AppImage

# 清理用户数据
rm -rf ~/.config/OpenHuman
rm -rf ~/.local/share/OpenHuman

下一步

装好之后，继续：

首次启动配置 —— 详细的 setup 流程，从启动到能用大约 30 分钟

← 上一页系统要求下一页 → 首次启动配置