OpenHuman 安装指南：Windows / macOS / Linux 一键安装教程

OpenHuman 是一个开源的桌面端个人 AI 智能助手，目前提供了三种安装方式：双击安装包、命令行一键安装、从源码编译。本文详细介绍每个平台下的安装步骤。

Windows 安装

Windows 用户安装最简单。前往 OpenHuman 官网（openhuman.cn）下载 Windows EXE 安装包，双击运行即可。

• 下载后双击 .exe 文件
• 如果系统提示安全警告，点击"仍要运行"
• 安装程序会自动完成安装，约 1-2 分钟
• 安装完成后桌面会显示 OpenHuman 图标

Windows 10+ 均可运行，需要 4GB 以上内存。

macOS 安装

下载 macOS DMG 安装包，双击挂载后将 OpenHuman 拖入 Applications 文件夹。

• 首次打开需要在"系统偏好设置 → 安全与隐私"中允许打开
• 支持 Apple Silicon（M1/M2/M3）和 Intel 芯片
• macOS 12+ 均可运行

Linux 命令行安装

一条命令即可安装：

curl -fsSL https://get.openhuman.cn | bash

这个脚本会自动检测你的 Linux 发行版，安装依赖并配置运行环境。

从源码编译安装

如果你无法使用上述安装方式，或者想体验最新特性，可以从 GitHub 源码编译：

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
npm install -g pnpm@10.10.0
pnpm install
pnpm dev

编译需要 Node.js 24+ 和 Rust 工具链（因为 OpenHuman 使用 Tauri 框架，后端是 Rust）。首次编译约 10-15 分钟。

安装后配置

安装完成后，打开 OpenHuman 会看到引导页面：

• OAuth 连接你的 Gmail、GitHub、Notion 等账户
• 配置模型 API Key（可选，内置模型可直接使用）
• 开启 Auto-fetch 自动同步
• 设置语音和桌面吉祥物偏好

从安装到可以开始对话，约 5 分钟。

常见问题

安装后打不开

检查系统版本是否满足要求（Windows 10+ / macOS 12+ / Linux kernel 5.x+）。如果满足，尝试重新下载安装包。

命令行安装脚本报错

确认已安装 curl 和 bash。如果网络问题导致下载失败，尝试使用代理或从 GitHub Releases 手动下载。

想要汉化界面

OpenHuman 自动检测系统语言，如果你的系统是中文，界面会显示中文。如果默认是英文，可以在设置中手动切换语言。