openhuman portable · manual

openhuman portable明镜

Desktop AI Super Intelligence · Local Memory · Deep Reasoning

壹

简介

OpenHuman Portable 是 OpenHuman（TinyHumans 出品，31k+ stars）的「开箱即用」便携版本。

OpenHuman 是一个基于 Tauri + CEF（Chromium Embedded Framework）的桌面级 AI 超级智能应用，拥有本地记忆、深度推理、多供应商支持等能力。

与 OpenClaw / Hermes / Claude / Codex 不同，OpenHuman 是 GUI 桌面应用，自带完整的设置界面，无需外部配置中心。
贰

启动方式

macOS

chmod +x OpenHumanPortable.command
./OpenHumanPortable.command

Linux

chmod +x OpenHumanPortable.sh
./OpenHumanPortable.sh

Windows

双击 OpenHumanPortable.bat

首次启动会自动打开使用指南页面，按引导配置即可。

叁

首次配置

1. 登录方式

启动后显示 Welcome 页面，可选择：

2. 密钥环授权

首次启动桌面版会弹出 Keyring Consent 对话框，点击 Accept 授权本地加密存储。

3. 运行模式

模式说明推荐
CloudOpenHuman 托管一切，开箱即用推荐
Custom自选供应商，BYOK 模式进阶用户
Local实验性，跳过登录开发者
肆

配置 API Key（BYOK）

在 OpenHuman 界面中操作：

  1. 点击左下角 ⚙️ 设置（或 ⌘+, (Mac) / Ctrl+, (Win/Linux)）
  2. 进入 AI & Models
  3. 点击要启用的供应商芯片 → 粘贴 API Key → 确认
  4. 或点击 Add Custom Provider 添加自定义 OpenAI 兼容端点
推荐使用 OpenRouter 作为统一入口，一个 Key 访问所有模型。
伍

特性

忆
本地记忆
Memory Tree 本地存储，对话历史自动压缩为长期记忆，越用越懂你。
思
深度推理
支持多种推理模式：Chat、Reasoning、Agentic、Coding，按任务自动路由。
连
多供应商
内置 26+ 供应商：OpenAI、Anthropic、Google、DeepSeek、Groq 等。
密
零污染
所有数据存储在便携包内，通过 HOME 重定向实现零宿主机污染。
桌
桌面原生
Tauri + CEF 桌面应用，原生体验，支持系统通知、快捷键、托盘图标。
开
开源 MIT
上游 OpenHuman 开源，MIT 许可证。便携包同样 MIT 开源。
陆

目录结构

OpenHumanPortable/
├── OpenHumanPortable.command  ← macOS 启动器
├── OpenHumanPortable.sh       ← Linux 启动器
├── OpenHumanPortable.bat      ← Windows 启动器
├── lib/
│   └── first-launch.html      ← 首次启动指南
├── bin/
│   ├── macos-arm64/           ← Apple Silicon
│   ├── macos-x64/             ← Intel Mac
│   ├── linux-x64/             ← Linux x86_64
│   └── windows-x64/           ← Windows
├── data/
│   ├── .home/                 ← 重定向的 HOME（零污染）
│   └── .openhuman/            ← OpenHuman 数据
│       ├── config.toml        ← 配置文件
│       ├── workspace/         ← 记忆、会话、工作区
│       └── cef-cache/         ← CEF 缓存
├── setup.sh                   ← 下载脚本
└── VERSION
柒

环境变量

变量值说明
HOMEdata/.home重定向 HOME 目录，实现零污染
OPENHUMAN_WORKSPACEdata/.openhumanOpenHuman 数据目录
OPENHUMAN_CEF_CACHE_PATHdata/.openhuman/cef-cacheCEF 缓存目录
不要手动修改这些环境变量，启动器会自动设置。
捌

常见问题

数据存储在哪里？

所有数据在 data/.openhuman/ 目录内。拔出 U 盘后，宿主机不留痕迹。

如何更新？

下载新版便携包，将 data/ 目录复制到新版即可保留配置和记忆。

支持哪些模型？

OpenAI、Anthropic、Google Gemini、DeepSeek、Groq、OpenRouter 等 26+ 供应商。也可以添加任何 OpenAI 兼容的自定义端点。

需要联网吗？

使用云端模型需要网络。本地模式（实验性）可以离线使用，但需要额外安装 Ollama 或 LM Studio。

macOS 提示"已损坏"？

启动器会自动执行 xattr -dr com.apple.quarantine。如果仍有问题，右键打开或在系统设置中允许。

玖

五器各司其用

字工具别名定位
匣openclaw百川多模型多渠道，一匣纳百川
砚hermes砚墨记忆生长，越用越懂你
刃claude portable利刃终端编程搭档
盒codex portable方盒OpenAI 阵营对照
镜openhuman明镜桌面级 AI 超级智能
yu.ai openhuman portable · 明镜 mit