OpenHuman 安装教程（2026 最新版）：5 分钟搭建你的 AI 数字分身

AI 手记  ·  2026.05.29  ·  约 10 分钟阅读

用户在桌面使用笔记本电脑安装配置 OpenHuman 个人 AI 数字分身

如果你已经在 GitHub 上刷到 OpenHuman 却还没动手，这篇就是2026 年最短的落地路径：从下载安装到第一次让 Agent 说出「我知道你今天下午有会」——全程按表操作，熟练用户约 5 分钟（含 OAuth 弹窗与首轮同步等待）。OpenHuman 不是又一个聊天网页，而是桌面级个人 AI 数字分身：本地记忆树、118+ 服务 OAuth、约 20 分钟一轮的后台同步。装好之后，你可以再读我们关于架构与记忆树、Agent Skill 的深度文章；本文只解决「怎么装、怎么配、怎么确认成功」。

5
分钟上手（含 OAuth）
118+
可 OAuth 集成
20
分钟同步周期

安装前要准备什么

OpenHuman 是 Tauri 桌面应用（Rust 核心 + Web UI），官方支持 macOS、Windows、Linux。2026 年主流路径仍以 Apple Silicon Mac 体验最好——与本地 Ollama、MLX 推理同机部署时延迟更低。安装前请确认：

  • 系统权限— macOS 需在「隐私与安全性」里允许下载的 App（或从 App Store 外安装时右键「打开」）。
  • 至少一个 LLM 凭据— Anthropic / OpenAI API Key，或本机已运行的 Ollama（可选）。没有 Key 也能进界面，但 Agent 无法推理。
  • 准备 2–3 个要接的账号— 建议首轮就接 Gmail + Google Calendar + GitHub（开发者）或 Notion + Slack（知识工作者），否则记忆树空转，5 分钟验收会失败。
  • 磁盘与网络— 记忆树写本地 SQLite + Markdown，预留数百 MB；OAuth 与首轮抓取需要稳定网络。

完整依赖与从源码构建见官方仓库 docs/；日常用户无需克隆仓库。建议先在终端跑一遍环境自检，避免装到一半才发现架构或 Homebrew 未就绪：

安装前自检（macOS 终端） 
# 1. 系统与芯片（Apple Silicon 为 arm64）
sw_vers
uname -m

# 2. Homebrew 是否可用（走 brew 安装时需要）
brew --version
brew doctor

# 3. 若计划用本地 Ollama，先确认 11434 端口未被占用
lsof -i :11434 || echo "端口 11434 空闲，可启动 Ollama"

# 4. 磁盘空间（记忆树 + 模型缓存，建议 ≥5GB 可用）
df -h ~

三种安装方式：官方包、Homebrew、脚本

官方 README 明确：优先使用带签名的原生安装包或系统包管理器，脚本安装适合快速体验，但供应链风险更高。下表按推荐顺序排列。

方式适用命令 / 入口
官方安装包（推荐）macOS / Win / Linuxtinyhumans.ai/openhuman 或 GitHub Releases（DMG / MSI / deb / AppImage）
Homebrew（macOS / Linux）习惯终端的 Mac 用户brew tap tinyhumansai/core → brew install openhuman
一行脚本（演示用）快速试玩、CI 沙箱curl -fsSL …/install.sh | bash（可先 --dry-run）
方式 A · 官方 DMG（GUI + 命令行辅助） 
# 在浏览器打开最新 Release（选与你芯片匹配的 arm64 / x64）
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# 或官网下载页
open "https://tinyhumans.ai/openhuman"

# 下载完成后，可用命令行挂载 DMG 并复制到「应用程序」（文件名以实际为准）
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# 若 macOS 拦截「无法验证开发者」，移除隔离属性后再打开
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman
方式 B · Homebrew（2026 官方推荐，可重复升级） 
# 1. 添加官方 tap（只需执行一次）
brew tap tinyhumansai/core

# 2. 安装（会拉取当前 stable 二进制）
brew install openhuman

# 3. 验证是否进 PATH
which openhuman
openhuman --version

# 4. 启动桌面端（CLI 会唤起 App，或从启动台点 OpenHuman）
openhuman

# 5. 日后升级
brew update
brew upgrade openhuman

# 备选：不添加 core tap 时，部分文档写法为
# brew install tinyhumansai/openhuman/openhuman
方式 C · npm 全局安装（跨平台，需 Node ≥ 18） 
# 检查 Node 版本
node -v

# 安装 npm 包（首次会下载对应平台原生二进制并校验 SHA-256）
npm install -g openhuman

openhuman --version
openhuman
方式 D · Debian / Ubuntu · apt 签名源 
# 1. 导入 GPG 并添加 apt 源（官方 install 文档步骤）
sudo apt-get install -y gnupg2 curl ca-certificates
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

# 2. 安装并启动
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version
方式 E · 一行脚本（先预览再执行） 
# 1. 只下载脚本，不执行（建议先看内容）
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. 官方支持 dry-run 预览（若脚本版本包含该参数）
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. 确认无误后再安装
bash /tmp/openhuman-install.sh

# macOS / Linux 一行版（等价于上面第 3 步）
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

安全提示

管道脚本（curl | bash）在任意项目上都存在供应链风险。公司环境请走 签名 DMG + MDM 分发，或内部镜像 Homebrew tap；个人学习可用脚本，但勿在生产密钥所在的机器上裸跑。

macOS 分步命令：从安装到验收（完整示例）

下面是一条可复制的终端 + GUI 混合路径：默认你用 Homebrew 安装，并用 Anthropic API；若你走 DMG，可从「步骤 3」开始。每步后都给出了如何确认成功。

步骤 1–2 · 安装并确认进程 
brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# 确认 App 已在运行（应看到 OpenHuman 相关进程）
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep
步骤 3 ·（可选）先在本机拉起 Ollama，供「本地模型」选项使用 
# 安装并后台启动 Ollama（与 OpenHuman 分开，但可共用本机 GPU）
brew install ollama
brew services start ollama

# 拉取一个小模型做连通性测试（体积与名称可按需替换）
ollama pull llama3.2

# API 探活：应返回 JSON，含 models 列表
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo
步骤 4 · 在 OpenHuman 里配置模型（GUI + 终端辅助） 
# GUI：Settings → Models / Providers
#   - 云端：粘贴 Anthropic API Key（sk-ant-...）或 OpenAI Key
#   - 本地：Base URL 填 http://127.0.0.1:11434 ，模型选 llama3.2 等

# 勿把 Key 写进 shell 历史；若必须用环境变量做 CLI 测试，用临时 export：
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# （输入后回车，终端不回显；用完可 unset ANTHROPIC_API_KEY）

# 快速验证 Anthropic 密钥是否有效（与 OpenHuman 无关的独立探针）
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo
步骤 5 · OAuth 集成（GUI 为主，无统一 CLI） 
# GUI：Connections / Integrations → 依次点击 Connect
#   建议顺序：Gmail → Google Calendar → GitHub
# 浏览器完成 OAuth 后，回到 App 应显示 Connected / Active

# 若公司代理导致回调失败，可先测 HTTPS 出站：
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5
步骤 6 · 等待同步并检查记忆树目录 
# 保持 OpenHuman 运行 5–20 分钟；可在菜单栏查看同步状态
# 数据目录因版本而异：先在 App「Settings → Data / Memory」查看路径
# 常见在 Application Support 下，可用 find 粗查（可能需几秒）：
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# 若已知记忆树根目录为 $MEMORY_DIR，列出最近 Markdown：
# MEMORY_DIR="…/memory"   # 替换为设置页显示的路径
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# 抽查某个 .md 是否含真实主题行（邮件/会议/PR）
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"
步骤 7 · 对话验收（在 App 聊天框输入，示例如下） 
# 测试 1 — 日历（需已接 Google Calendar）
「列出我今天的会议标题与开始时间，引用记忆树里的来源。」

# 测试 2 — GitHub（需已接 GitHub）
「我最近在哪个仓库有合并的 PR？给出仓库名与 PR 标题。」

# 失败时：回答若明显泛泛而谈，回到步骤 6 确认 .md 是否生成

5 分钟首次配置清单（按顺序打勾）

若你更习惯 checklist 而非长命令，可按下面打勾；与上一节命令一一对应。计时从应用已打开开始。

  1. 第 1 分钟：选模型提供商— Settings 填入 Anthropic / OpenAI Key，或 Ollama Base URL http://127.0.0.1:11434；用 curl …/api/tags 或 Anthropic 探针确认密钥有效。
  2. 第 2–3 分钟：OAuth 连接— Connections 里 Connect Gmail、Calendar、GitHub；浏览器授权后状态为 Connected。
  3. 第 4 分钟：触发首轮同步— App 保持运行；find ~/Library/Application Support -iname '*openhuman*' 找到数据目录后，确认有今日 .md。
  4. 第 5 分钟：验收对话— 用上一节「测试 1 / 2」提问；能引用具体事实即成功。

连接服务与验证记忆树

OpenHuman 的「数字分身」感来自记忆树：第三方数据被规范化为 ≤3k token 的 Markdown 块，写入本机 SQLite，并导出为可用 Obsidian 打开的 .md 文件。验证是否工作，不要只看 UI 绿灯，要看文件是否落地：

  • 在应用内打开 Memory Tree / 记忆目录，确认有新文件且时间戳为今天。
  • 用文本编辑器打开任一 .md，应能看到邮件主题、会议标题、PR 名称等可核对的事实，而非空模板。
  • 可选：与 agentmemory 共用后端，让 OpenHuman 与 Claude Code 共享持久记忆（进阶）。
记忆树 / SQLite 粗查（将 MEMORY_DIR 换成设置页路径） 
# 统计今日新增 Markdown 数量
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# 看最新 3 个片段修改时间
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# 若目录旁有 SQLite（文件名因版本而异），可看表数量（需 sqlite3）
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

若你关心「和 ChatGPT 有什么区别」：ChatGPT 的上下文在对话里；OpenHuman 的上下文在你磁盘上可审计的文件里——这也是它在 GitHub 走红的原因。更多产品背景见五天体验文。

和 OpenClaw 怎么分工？

OpenHuman 管个人上下文（邮件、日历、笔记）；OpenClaw 更偏 IM 编排与构建流水线。装 OpenHuman 不会替代 Xcode CI；装 OpenClaw 也不会自动读懂你的收件箱。两者可并存。

Mac 用户进阶：本机 vs 云端 Mac 常驻

OpenHuman 设计为桌面常驻：合盖休眠会拖慢同步。若你希望「下班电脑关机、分身仍在拉邮件摘要」，可以把实例放在始终在线的 Mac mini 上——例如 ZavCloud 云端 Mac 独享节点：真实 macOS、静态 IP，便于 OAuth 回调与长期后台任务。注意：OAuth 令牌与记忆树文件仍属敏感数据，云端部署要单独做磁盘加密、访问控制与备份策略，不要把个人 Gmail 直接丢在共享多租环境。

本地 Apple Silicon 上还可搭配 Ollama / MLX 做离线推理，与 OpenHuman 的「数据在本地」叙事一致；模型在本地、记忆在本地，只有集成同步走外网。若你做 iOS 开发，编码仍建议用 Cursor / Claude Code，开工前问 OpenHuman「今天会议多吗」——我们在Anthropic 与 Claude Code一文里写过类似的混搭工作流。

云端 Mac 常驻（示意：SSH 登录后同样 brew 安装） 
# 登录你的 macOS 云主机后
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# 无图形界面时，部分版本支持仅跑同步引擎；以官方文档为准
# 建议：VNC/屏幕共享完成首次 OAuth，再把会话保持登录

# 防止合盖休眠中断同步（按机房策略选用）
sudo pmset -c sleep 0 displaysleep 0

常见问题排查

  • 安装后无法打开（macOS）— 系统设置 → 隐私与安全性 → 仍要打开；或右键 App → 打开。企业 MDM 可能拦截未公证包，改走 Releases 里的签名 DMG。
  • OAuth 回调失败— 检查代理/VPN、系统时间、浏览器是否拦截弹窗；公司网络可能封锁 Composio 域名，需 IT 加白名单。
  • 记忆树一直为空— 确认集成显示 Connected；等待一个完整同步周期（约 20 分钟）；查看官方 Issues 是否有你所在地区的 API 限流。
  • Agent 胡编— 记忆未写入或模型未启用「读记忆」工具；缩小问题范围，@ 指定记忆文件测试（若版本支持）。
  • brew install 找不到— 先 brew tap tinyhumansai/core 再 install；Intel Mac 请核对 Releases 是否提供对应架构。
排错命令速查 
# Homebrew 安装失败：清缓存重试
brew update
brew cleanup
brew reinstall openhuman

# 应用崩溃后查看 macOS 崩溃日志
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama 已启动但 OpenHuman 连不上
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# 完全卸载后重装（brew 路径）
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# 查看官方仓库最新 Issue（需 gh CLI）
gh issue list -R tinyhumansai/openhuman -L 5
进阶 · 从源码运行（贡献者 / 调试，非 5 分钟路径） 
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# 仅 Web UI
pnpm dev
# 完整 Tauri 桌面开发
pnpm dev:app
# Rust 侧检查
cargo check -p openhuman --lib

FAQ

必须联网吗？ 安装、OAuth 与云端模型要网；记忆文件在本地。本地 Ollama 可弱网对话，但邮件/日历同步仍需网。

免费吗？ 客户端开源（GPL-3.0）；模型 API 与部分连接器可能产生第三方费用，以你选的提供商账单为准。

和 Cursor Rules / Claude Code 冲突吗？ 不冲突。OpenHuman 不编辑你的仓库；编码 Agent 不读你的 Gmail。各管一层。

ZavCloud · 云端 Mac

分身要 24 小时在线？用真 macOS 常驻节点

Mac mini M4 独享实例：原生 macOS、静态 IPv4——适合跑 OpenHuman 后台同步、Ollama 与 Xcode 同一台可审机器。

查看方案与定价
Cloud Mac在线租用 Mac mini