OpenHuman

项目简介

OpenHuman 是一个本地优先的开源个人 AI 智能体平台。它把"大脑 + 编排器 + 深度研究员"三合一，提供持久记忆、多代理编排、可视化工作流等能力，可作为桌面应用安装使用。项目仍处于早期 Beta 阶段。

安装方式

从官网下载安装包，或在 GitHub Releases 页面获取。也可通过 Homebrew、Debian/Ubuntu .deb、AUR 等终端方式安装，详见 INSTALL.md。

三大核心特性

大脑：持久化本地记忆

• 记忆树 + Obsidian Vault：把个人数据压缩为评分化的 Markdown 树，存储在本地 SQLite 中，并镜像为可编辑的 Obsidian 知识库。
• 广泛集成：内置 100+ OAuth 集成、5000+ MCP 服务器、90000+ Skills，覆盖 Gmail、Notion、GitHub、Slack 等。Auto-fetch 每 20 分钟自动拉取数据。
• 目标与待办：长期目标、线程内持久目标，以及协作看板。
• TokenJuice：在送入模型前压缩工具输出，最高减少 80% token 消耗。

编排器：多代理调度

• 工作流：代理在画布上提出自动化方案，用户审核后保存。基于开源 tinyflows 构建，支持定时、Webhook、消息事件触发，副作用受审批门控。
• 检查点图运行：基于开源 tinyagents 运行检查点化图，代理卡住会被引导中止并返回根因，每次运行都可重放并查看逐次成本。
• 双脑架构：快速反射代理负责分流入站流量，深度推理核心委派给 Worker 集群。
• 代理经济：在 tiny.place 上拥有 @handle，基于 Signal 协议的端到端加密代理通信，配套 x402 USDC 赏金与交易机制，私钥不落磁盘。

深度研究员与执行者

• 开箱即用的工具集：托管 Web 搜索（由 Exa 提供）、爬虫、代码工具集、真实浏览器、原生语音（进程内 Whisper）。模型路由按工作量自动选模型，也支持自带 Ollama 本地模型或第三方 Key。
• 图像与视频生成：在统一订阅下生成 Seedream/SeedEdit 图像与 Seedance/Veo 视频。
• 17 种消息通道：Telegram、Discord、Slack、WhatsApp、Signal、iMessage 等，以及原生邮件支持（IMAP IDLE + SMTP）。

隐私与本地化

应用强调 UI 优先，几步点击即可使用，无需配置文件或终端。提供 OS Keyring 存储密钥、可选沙箱。Privacy Mode 可一键启用，强制所有推理留在本机，由 Rust 内核保障执行。

配置示例

对于已经自部署 agentmemory 的用户，可以在 config.toml 中将后端指向它：

memory.backend = "agentmemory"

这样同一套持久记忆可同时服务 OpenHuman 与 Claude Code、Cursor、Codex、OpenCode 等其他编码代理。

主题与界面

提供五套主题家族和完整的可视化编辑器（Theme Studio），主题可导出为 JSON。还拥有一个会说话、会反应、会记住用户的吉祥物形象。

与其他代理框架对比

OpenHuman 在以下维度区别于 Claude Cowork、OpenClaw、Hermes Agent 等：开源许可（GNU）、简单上手、一站式订阅、Memory Tree + Obsidian 双重记忆、大规模集成与 Auto-fetch、代理图 + 检查点编排、可视化工作流、会议加入能力、17 种消息通道、一键 Privacy Mode、可重放运行日志与逐次成本、内置模型路由、丰富的原生工具集。

源码贡献

1. 安装 Git、Node.js 24+、pnpm 10.10.0、Rust 1.93.0（包含 rustfmt 与 clippy）、CMake、Ninja、ripgrep，以及桌面端构建依赖。
2. Fork 并克隆仓库，先执行 git submodule update --init --recursive，再运行 pnpm install 以拉取 Tauri/CEF 源码。
3. 常用命令： - 仅 Web UI 开发：pnpm dev - 桌面壳开发：pnpm --filter openhuman-app dev:app - 检查：pnpm typecheck、pnpm format:check、cargo check -p openhuman --lib

详细架构与部署文档可查阅官方 Architecture、Getting Set Up 与 Cloud Deploy 指南。