首页 / Hermes Agent 教程 / 运行形态与平台支持

← 上一篇 下一篇 →
Hermes Agent 教程

运行形态与平台支持

本教程共 25 篇 · 第 3 篇 · 更新于 2026-07-26 · 约 10 分钟阅读

Hermes AgentHermes Agent 教程运行形态平台支持Docker桌面版Tier1

3. 运行形态与平台支持

本节目标：搞清楚 Hermes Agent 有几种跑法、各自适合什么场景，以及官方对哪些平台负责、哪些不负责。学完你能根据自己的环境选对运行形态。

一个核心，多种形态

先建立一个重要认知：Hermes Agent 不管长什么样，底层都是同一个智能体。

它有几个前端，都连着同一个核心—同样的配置、同样的 API Key、同样的会话、同样的技能、同样的记忆。你在终端里用 hermes 建的会话，在桌面版里能接着聊，反过来也行。

打个比方：这就像你的微信—手机版、电脑版、网页版界面不同，但背后是同一个账号、同一套聊天记录。Hermes Agent 的多种形态也是这个逻辑。

下面逐个看这八种形态。

形态一：桌面版（Desktop App）

桌面版是一个原生应用，目前支持 macOS、Windows 和 Linux。

它不是 CLI 的简陋包装，而是一个完整的图形界面，围绕同一个智能体核心构建。你用 hermes 在终端里做的所有配置，桌面版里直接就有；你在桌面版里做的任何改动，终端里也能看到。

桌面版能做什么：

  • 流式对话，实时显示工具调用过程
  • 左侧导航栏管理多个并行对话
  • 拖拽文件到聊天区直接附件
  • 右侧预览栏，边聊边看网页、文件、工具输出
  • 文件浏览器，不离开应用就能看工作目录
  • 语音模式（macOS 首次会弹麦克风权限）
  • 图形化设置：提供商、模型、工具、凭据都能在界面里配，不用编辑 YAML
  • 技能、定时任务、Profile、消息平台的管理面板
  • 命令面板（Cmd+K / Ctrl+K），键盘党友好
  • 界面语言切换，支持简体中文

怎么启动：

hermes desktop

如果你还没装桌面版，这个命令会自动构建并启动。它用的是你当前的配置、密钥、会话和技能。

Tip

桌面版还能连接远程后端—比如你在 VPS 上跑着一个 hermes serve 进程，桌面版可以连过去，像操作本地一样操控远程智能体。这对「云端跑 Agent、本地用桌面界面操作」的玩法很有用。

形态二：CLI / TUI

这是最经典的形态，在终端里直接用。

hermes              # 经典 CLI（基于 prompt_toolkit）
hermes --tui        # 现代 TUI（推荐）

两者共享同一套会话、斜杠命令和配置，区别在于交互体验：

  • 经典 CLI：稳定、轻量，所有终端都能跑。
  • 现代 TUI：有模态浮层、鼠标选择、非阻塞输入，体验更接近现代编辑器。

CLI/TUI 的特点：

  • 多行编辑（Alt+Enter 或 Ctrl+J 换行）
  • 斜杠命令自动补全（输入 / 弹出命令列表）
  • 对话历史回溯
  • 中断重定向：Agent 跑太久时，直接发新消息就能打断当前任务并切到新指令
  • 流式工具输出
Note

Shift+Enter 换行需要终端支持 Kitty 键盘协议（Kitty / foot / WezTerm / Ghostty 默认支持；iTerm2 / Alacritty / VS Code 终端需要手动开启）。Alt+Enter 和 Ctrl+J 在所有终端都能用。

形态三：Docker

Docker 和 Hermes Agent 有两种关系，别搞混：

  1. 在 Docker 里跑 Hermes：智能体本身跑在容器里（本节重点）
  2. Docker 作为终端后端：智能体跑在宿主机上，但每条命令都在一个 Docker 沙箱容器里执行

第一种是部署方式，第二种是安全隔离方式。

快速启动（交互式初始化）：

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

这会进入设置向导，让你填 API Key，写入 ~/.hermes/.env。只需要做一次。

后台常驻网关模式：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

容器里所有用户数据（配置、API Key、会话、技能、记忆）都存在挂载目录 /opt/data 里，镜像本身是无状态的。升级只需要拉新镜像，配置不丢。

Tip

官方 Docker 镜像用 s6-overlay 做 PID 1 进程管理：网关崩了会在几秒内自动重启，每个 Profile 都有独立的监管服务槽。所以推荐「一个容器跑所有 Profile」，而不是一个 Profile 一个容器。

形态四：Web 仪表盘（Web Dashboard）

hermes dashboard

这是一个浏览器管理面板。它和桌面版不一样—桌面版是原生应用，仪表盘是网页。仪表盘里有个可选的「Chat」标签页，通过伪终端嵌入 TUI。

仪表盘适合远程管理：你在服务器上跑着 Hermes，不想装桌面应用，用浏览器就能管。它支持 Profile 切换、配置编辑、技能管理等。

Warning

仪表盘绑定非本地地址（比如 0.0.0.0）时会自动开启认证门。2026 年 6 月的一次安全加固后，不再有不认证的逃逸口—HERMES_DASHBOARD_INSECURE=1 已经废弃成空操作。暴露在公网必须配置认证提供商（用户名密码、Nous Portal OAuth 或自托管 OIDC）。

形态五：Windows 原生

Windows 10/11 不用装 WSL 就能完整跑 Hermes Agent。CLI、网关、TUI、工具都原生支持。

安装方式是 PowerShell 一行命令（见上一章）。文件装在 %LOCALAPPDATA%\hermes。

少数功能在 Windows 原生上不可用（主要是依赖 Linux 特性的部分），具体差异可以看官方文档的功能矩阵。如果你需要完整功能，WSL2 是备选。

形态六：WSL2

WSL2 本质上就是 Linux 环境，所以 Linux 的安装脚本在 WSL2 里直接能用：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

装完文件在 ~/.hermes，和原生 Linux 一样。WSL2 的好处是功能完整（毕竟就是 Linux），坏处是多了层虚拟化的开销，文件系统跨边界访问有点慢。

形态七：Nix

Nix 是 Tier2 平台，属于「尽力而为」的支持。

如果你已经在用 Nix（NixOS、macOS 或 Linux 上的 Nix），有专门的 Nix flake、声明式 NixOS 模块和可选容器模式。但官方坦言这个路径「经常因为 Node.js 打包问题而坏掉」。

Note

Nix 不再是官方明确支持的安装路径，仅做尽力维护。能用就用，坏了不保证及时修。

形态八：Termux（Android）

在 Android 手机上通过 Termux 跑 Hermes Agent。安装命令和 Linux 一样：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

但 Termux 装的是精简依赖集 .[termux]，因为完整的 .[all] 会拉取 Android 不兼容的语音依赖。少数功能在手机上不可用。

这意味着你可以在手机上跑一个智能体—出门在外用 Telegram 跟它聊，它在后台帮你干活。

平台分级：Tier1 与 Tier2

官方把平台支持分成两个等级，这个分级口径以 platform-support.md 为准。

Tier 1：优先保障

这些平台是官方的第一优先级，出了问题会优先修，力求安装和更新永远不坏。

平台安装方式
macOS（Apple Silicon）桌面安装器、install.sh
Windows 10/11（x86_64, aarch64）桌面安装器、install.ps1
Linux / WSL2（x86_64, aarch64）install.sh
Docker 容器（x86_64, aarch64）docker pull

Tier 2：尽力而为

这些平台在代码库里维护，但属于「best effort」—版本更新可能搞坏它们，官方不保证及时修。接受社区 PR，但优先级低于 Tier 1。

平台安装方式
Android（Termux，aarch64）install.sh
Nix（macOS、Linux、NixOS）install.sh 或 Nix flake

不支持

以下平台和分发方式明确不支持，可能现在已经坏了，未来可能更坏。官方不接受修复它们的 PR，保持兼容的代码也可能随时被删：

  • 通过 AUR 安装
  • macOS x86（Intel 处理器）
  • 通过 pypi 安装（如 pip install hermes-agent、uv tool install hermes-agent）
  • 通过 brew 安装（brew install hermes-agent）
Warning

如果你在用不支持的分发方式，建议迁移到支持的方式。Intel Mac 用户没有官方路径，可以考虑升级到 Apple Silicon 或者用 Linux/Docker。

怎么选

给个简单的决策参考：

  • 个人电脑日常用：桌面版（macOS/Windows/Linux）
  • 服务器 / VPS 长期跑：Docker 或直接 install.sh
  • 纯命令行党：CLI 或 TUI
  • 远程管理：Web 仪表盘 + 桌面版连远程后端
  • Windows 用户：原生 Windows（够用）或 WSL2（功能全）
  • 手机党：Termux
  • Nix 用户：能跑就跑，坏了别太指望官方
Tip

不管选哪种形态，核心都是同一个智能体。你可以今天用桌面版，明天出差用手机 Termux 连同一个 VPS 上的实例，体验是无缝衔接的—因为状态都存在 ~/.hermes/ 里。

下一章我们深入 ~/.hermes/ 这个目录，看配置文件和 Profile 体系怎么运作。

上一篇
安装与一键部署
下一篇
配置文件与 Profile 体系