OpenHuman 从零到上手（2026年5月最新版）
OpenHuman 从零到上手（2026年5月最新版）
刚发布不到一个月，GitHub 就冲到了 18,400+ 星。本文带你从安装到跑通第一个任务，全程手把手。
⚠️网络提示：GitHub 和 Google 服务在中国大陆访问受限。本文已标注替代方案，让你在国内网络下也能顺利上手。
第一步：准备工作
你需要什么
| 条件 | 说明 | 国内注意 |
|---|---|---|
| 操作系统 | Windows 10+ / macOS 12+ / Ubuntu 20.04+ | - |
| 网络 | 需要访问 GitHub（下载安装包） | 见下方镜像方案 |
| 账号 | GitHub 账号（用于 OAuth 登录） | 注册 GitHub 本身不需要梯子 |
| 可选连接 | Gmail、Calendar 等 | 这些服务在国内无法使用，可以跳过，用国内替代 |
国内用户网络方案
下载安装包：GitHub Releases 在国内下载慢或打不开。用以下镜像：
# 使用 ghproxy 加速（推荐）https://ghproxy.com/https://github.com/tinyhumansai/openhuman/releases/download/v0.54.0/OpenHuman_0.54.0_x64-setup.exe把链接里https://github.com替换成https://ghproxy.com/https://github.com即可。
如果不想用命令行安装，直接去 Releases 页面 下载.exe或.dmg安装包（可能需要梯子，或找人帮下载）。
关于 OAuth 服务：Gmail、Google Calendar、Google Meet——这些在国内连不上，直接跳过，不影响核心功能。可以接的国内服务：GitHub（网站本身可访问）、Notion（可访问）、Slack（可访问）。
不需要 Python、Node.js、Docker 环境——安装包自带一切。
第二步：安装（2 分钟）
Windows
打开 PowerShell（右键开始菜单 → Windows PowerShell），粘贴：
irmhttps://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1|iex按回车，脚本会自动下载并安装。等待进度条走完。
macOS
curl-fsSLhttps://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh|bashLinux
curl-fsSLhttps://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh|bash安装包太大怎么办
如果网络慢，直接去 Releases 页面 下载对应系统的安装包：
- Windows 选
x64-setup.exe - macOS Apple Silicon 选
aarch64.dmg - macOS Intel 选
x64.dmg
当前最新版本是 v0.54.0（2026-05-19 发布）。
第三步：第一次启动
安装完成后，双击桌面图标启动。你会看到一个图形界面，不是终端。
3.1 初始界面
启动后是一个简洁的 onboarding 向导，分三步：
页面 1：欢迎
- 显示 OpenHuman 的吉祥物（一个会说话的小角色）
- 点击 “Get Started”
页面 2：连接账号（核心步骤）
- 你会看到一个服务列表：Gmail、GitHub、Notion、Slack、Calendar、Drive……
- 至少选 3 个：建议 Gmail + GitHub + Calendar
- 每个服务点 “Connect”，会弹出 OAuth 授权页
- 点"允许"即可，不需要手动填任何 API Key
页面 3：等待同步
- 点完所有连接后，OpenHuman 开始第一轮数据抓取
- 进度条显示：Fetching Gmail / Syncing GitHub / Loading Calendar……
- 第一次同步 3-6 分钟，之后每 20 分钟自动增量更新
3.2 踩坑：OAuth 一直转圈
如果某个服务的授权页面卡住了：
- 检查网络（可能需要梯子）
- 如果是 Google 服务（Gmail/Calendar），确保你的 Google 账号没有开启高级保护
- 实在不行先跳过这个服务，后续在 Settings → Integrations 里重新连接
第四步：验证它是否正常工作
同步完成后，在对话框里输入：
帮我总结一下今天 Gmail 里最重要的 3 封邮件它应该能准确列出——因为它已经把邮件拉到本地了。
再试一个：
我 GitHub 上最近有哪些未关闭的 Issue？如果它回答正确——说明自动同步跑通了，它已经有了你数据的上下文。
第五步：配置建议（让体验好 10 倍）
5.1 开启 TokenJuice（省钱）
Settings → LLM 设置 → 找到 TokenJuice → 开。
TokenJuice 是 OpenHuman 内置的压缩层。所有数据先压再送 LLM：HTML 转 Markdown、长 URL 缩短、冗余输出去重、CJK/emoji 保留不丢。
官方数据：成本和延迟降低高达 80%。
5.2 连接 agentmemory（多工具共享记忆）
如果你同时用 Claude Code、Cursor、Codex 等工具，可以在 Settings → Memory 里把后端设为agentmemory。
这样所有工具共享同一套记忆——OpenHuman 拉的数据，Claude Code 也能用到。
5.3 配置模型路由
Settings → Model Routing → 选 Auto。OpenHuman 会自己判断任务类型——推理型任务用推理模型、快速回答用小模型、图片相关用视觉模型——不用你手动切换。
第六步：跟 OpenClaw 和 Hermes 的核心区别
这不是评测，是帮你快速判断该用哪个：
| 场景 | 推荐 |
|---|---|
| 我要一个能自己了解我、不用我喂数据的助手 | OpenHuman |
| 我要接 Telegram/Discord 等多个聊天平台 | OpenClaw |
| 我要一个越用越聪明、会自己写技能的学习型 Agent | Hermes Agent |
| 我要深度编程辅助（重构、架构建议） | Claude Code |
| 我完全不懂代码，不想碰终端 | OpenHuman |
| 我追求稳定性和成熟生态 | OpenClaw |
常见问题
Q：国内网络能用吗？
可以。GitHub 下载用 ghproxy 镜像加速。Google 服务（Gmail/Calendar/Meet）在国内无法使用，直接跳过。核心功能不需要 Google 服务。
Q：支持中文吗？
对话完全支持中文。界面目前是英文的，但不影响使用。
Q：收费吗？
目前免费（Early Beta 阶段）。未来可能出付费版，但核心功能承诺保持开源。
Q：需要什么模型 API Key？
不需要单独申请。OpenHuman 内置了模型路由，用它的订阅就行。如果你想用自己的模型（比如本地 Ollama），在 Settings 里配置。
Q：和其他 Agent 冲突吗？
不冲突。很多人同时用 OpenClaw 和 OpenHuman——OpenClaw 负责消息通知，OpenHuman 负责数据理解和分析。
总结
OpenHuman 是 2026 年 AI 进化三部曲的第三部。从 OpenClaw（工具）到 Hermes（学习）到 OpenHuman（理解），每一代都在降低门槛。
如果你之前因为养龙虾太复杂而放弃，这个可以试试。安装 2 分钟，连接账号 2 分钟，等同步 3 分钟——总共不到 10 分钟就能体验一个懂你的 AI。
项目地址：github.com/tinyhumansai/openhuman
当前版本：v0.54.0
发布日期：2026-05-19