OpenHuman 是 TinyHumans AI 的开源桌面 Agent：Rust 核心 + Tauri 外壳，118+ OAuth 集成、本地 SQLite Memory Tree、Obsidian 兼容 Markdown 库，以及每 20 分钟 自动同步的 auto-fetch。截至 2026 年 5 月 GitHub 17,700+ Star、34 个版本、GPL-3.0 协议。
MacBook 合盖会中断 20 分钟同步与 TokenJuice 压缩，并在系统升级后丢失 TCC 授权。已为 OpenClaw 或 Understand-Anything 知识图谱 租用专属 Mac mini M4 的团队可复用同一台 NodeMac 作为 24/7 OpenHuman 主机。
为何专属 Mac mini M4 优于合盖的笔记本
| Factor | MacBook | NodeMac M4 |
|---|---|---|
| Auto-fetch | Sleep stops 20-min loop | 24/7 sync |
| TCC | Lost after OS upgrades | Re-grant once via VNC |
| Agents | Competes with daily apps | Colocate with OpenClaw 云端节点手册 or CI |
| Disk | Vault + git mirrors fill 256GB | 256GB+ agent workspace |
可引用结论：每个集成载荷规范为 ≤3,000 token Markdown 块；16GB M4 上连接 10–15 个工具首次全量 auto-fetch 约 45–90 分钟，之后每 ~20 分钟 增量。详见 Memory Tree 文档。
OpenHuman 架构：各层运行位置
- Desktop shell — Tauri + React UI, mascot, voice, screen intelligence; needs logged-in macOS session.
- Rust core — JSON-RPC on port 7788; Memory Tree, TokenJuice, tool dispatch.
- Managed services — Sign-in and OAuth via
api.tinyhumans.ai; memory stays on-device. - Integrations — 118+ OAuth connectors; auto-fetch every 20 minutes.
Source: OpenHuman GitHub; hardware: Apple Mac mini specs; product: TinyHumans OpenHuman.
OpenHuman 与 OpenClaw：如何选择
NodeMac 客户常用 OpenClaw 作为 MIT 网关自动化平面；OpenHuman 面向 OpenClaw macOS 安装指南.
| Dimension | OpenClaw | OpenHuman |
|---|---|---|
| Memory | BYO context files | Memory Tree + auto-fetch |
| Integrations | MCP/skills | 118+ OAuth |
| License | MIT | GPL-3.0 |
| Always-on | You wire polling | 20-min auto-fetch |
16GB 可舒适运行单一主 Agent；OpenClaw 网关与 OpenHuman 桌面并存请选 24GB 或拆分节点。OAuth 范围请先在专用租户 Mac 上最小化授权。
Memory Tree 与 auto-fetch 实践
- Ingest — 20-minute cron pulls integration payloads into
openhuman-core. - Canonicalize — ≤3k-token Markdown chunks in SQLite + Obsidian vault mirror.
- Backup — Tar
~/openhuman-workspace/nightly; pair with Understand-Anything 知识图谱 for code graphs.
NodeMac 八步 OpenHuman 操作手册
- 开通节点 — 在 NodeMac 定价页 选择 M4 16GB/256GB（亚太选东京/新加坡，美东选弗吉尼亚），月付约 $96.9。
- SSH 基线 — 确认 macOS 15+ 与 arm64；安装 Homebrew。
- 安装 OpenHuman —
brew tap tinyhumansai/openhuman && brew install openhuman或从 GitHub Releases 下载 .dmg。 - VNC 首次登录 — 通过 VNC 一次性授予辅助功能、屏幕录制与麦克风 TCC；参阅 OpenClaw VNC 与 SSH 矩阵。
- 连接集成 — 先 OAuth 关联 Gmail、Calendar、GitHub、Notion；等待一个 20 分钟 auto-fetch 周期。
- 验证 Memory Tree — 在设置中打开 Obsidian 库路径，确认 .md 块出现。
- 可选无头 core —
openhuman-core serve监听 7788；用 SSH 隧道访问，勿公网暴露。 - 备份与监控 — 每周打包
~/openhuman-workspace/；swap 持续超 2GB 时升级 24GB 或参阅 三平面路由矩阵。
故障排查
Auto-fetch 30 分钟后仍空库
症状：集成显示已连接但库为空。修复：在 UI 重新 OAuth；确认可访问 api.tinyhumans.ai；重启 core 或桌面应用。
远程 core 401 Auth failed
症状：桌面客户端指向 OPENHUMAN_CORE_RPC_URL 失败。修复：统一 bearer token 来源，勿混用环境变量与 core.token 文件。
若要在同一台 Mac 上部署自托管 ChatGPT UI 与本地 RAG，请参阅 Open-WebUI 本地知识库教程 —含 Docker、Ollama、8 步流程与 5 个 FAQ。
常见问题
OpenHuman 能替代 NodeMac 上的 OpenClaw 吗？
不能——OpenClaw 擅长网关与频道 Bot；OpenHuman 擅长 auto-fetch 个人记忆。两者并存建议 24GB+。
数据都在本地吗？
Memory Tree、Markdown 库与工作区配置在本地；默认仍使用 TinyHumans 托管登录与 Composio OAuth。
118 个集成需要多少内存？
通常只连 10–20 个：16GB 起步；屏幕智能 + Ollama 并行建议 24GB。
能在 Linux 跑 core、Mac 保留 UI 吗？
可以——见 云端部署文档；NodeMac 优势是原生 macOS TCC。
为何不用 MacBook？
20 分钟 auto-fetch 需要主机常醒；$96.9/月 专属 M4 将 OAuth 范围隔离在租户 Mac 上。