信息核对 2026.11

首页 / 阶段三 / Hermes

Hermes：另一种自托管形态

Nous Research 做的 agent，和 OpenClaw 属于同一个大类（自己部署、自己跑），但侧重不同：OpenClaw 的核心是「多渠道网关」，Hermes 的核心是「一个能装在各种地方的 agent」。它有桌面安装包，也有一条命令的脚本，还能整包装进 Docker。

命令行 + 桌面 自托管 需境外网络 有中文文档

01它和 OpenClaw 的关系

两者不是替代关系，官方甚至专门写了「从 Hermes 迁移到 OpenClaw」的文档——这反过来说明：很多人是两个都装过。

对比项OpenClawHermes
核心定位多渠道网关，把聊天软件接到 agentagent 本体，装在哪都能跑
上手入口Control UI（浏览器仪表板）终端 + 桌面应用
安装形态npm / 脚本脚本 / 桌面安装包 / Docker
适合谁想「从微信、Telegram 指挥」的人想在自己机器上长期跑一个 agent 的人

实际用起来，很多人的组合是：Hermes 当执行者，OpenClaw 当入口。先装哪个都行，但别指望装两个就变强——它们用的是同一批模型。

02四条安装路径，按你的场景选

路径 A：Linux / macOS / WSL2（一条命令）

Terminal官方安装脚本
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

国内访问慢的话，官方有中文镜像站 hermes-agent.ac.cn，安装命令相同（把域名换掉）。这是官方维护的入口，不是第三方镜像。

路径 B：Windows 原生 PowerShell

Windows PowerShell官方标注为早期测试阶段
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

注意这条命令的结构：iex 外面套 irm，括号不能少。写成 irm ... | iex 在某些情况下也能跑，但官方给的是括号形式，照抄最稳。

因为标注是早期测试版，Windows 原生路径可能遇到问题。如果反复失败，改用路径 C（桌面安装包）或路径 D（Docker），别在一条命令上耗。

路径 C：桌面安装器（不想碰终端就选这个）

Hermes 提供桌面版安装器：Windows 是签名过的 .appinstaller（MSIX 包），macOS 是 DMG。下载入口在官方文档的安装章节。装完是一个图形应用，配置流程和命令行版一致，只是换成了界面。

路径 D：Docker（最干净，适合折腾坏了随时重来）

Docker注意 ~/.hermes 是宿主机的配置目录
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

这条命令的含义：把宿主机的 ~/.hermes 挂到容器里的 /opt/data，然后跑 setup 初始化。配置存在宿主机上，所以容器删了重来，配置还在。

Windows 上跑这条要注意路径写法

~/.hermes 是 Linux/macOS 的写法。Windows 上要用绝对路径，例如 -v C:\Users\你的名字\.hermes:/opt/data，并且要确保这个目录提前建好。Docker Desktop 还需要你把这个盘加入共享目录。

验证

不同安装方式的验证命令不完全一样。装完先跑 hermes --version 试；如果提示命令不存在，去看安装脚本最后的输出——它通常会告诉你怎么把命令加进 PATH，或者告诉你正确的启动命令。

03首次配置

  1. 跑一次 setup。命令行安装通常会自动进入，Docker 方式则是命令里明确带 setup。它会问你模型提供商和 API Key。
  2. 选一个模型源。它支持的提供商在 setup 里会列出来。你没有境外 key 的话，看看有没有兼容本地服务的选项；没有就先解决模型，不然装完也用不了。
  3. 确认配置目录。默认在 ~/.hermes（Windows 是 C:\Users\你\.hermes）。这个目录里存着你的密钥，不要备份到公开网盘。
  4. 先在一个空目录试跑。和前面所有工具一样，第一次不要拿真实项目开刀。

04基本用法

标准流程先 cd 再启动，这条规矩没变
cd D:\projects\ai-test
hermes
你想要怎么做
重新配置模型再跑一次 setup，不用卸载重装。
查看当前可用命令hermes --help。所有 CLI 类工具都该先看这个。
只读分析指令里加「不要修改任何文件」。
跑长任务给它可验证的终点（测试通过、构建成功、脚本能跑出结果）。
换机器迁移把 ~/.hermes 目录带过去；或者按官方迁移文档走。

05三个实战

实战一：整目录体检

「扫描 D:\projects\my-site 下所有 html：列出缺失的 alt 属性、失效的相对链接、重复的 title。只出清单，不改文件。」 这类任务在任何 agent 上都好用，因为验收标准清晰。

实战二：让它把脚本写成「家人也能用」

「写一个脚本：双击后把 D:\下载 里的图片按年份归档到子文件夹。每一步打印中文提示，遇到同名文件不要覆盖，停下来告诉我。」 强调「不覆盖」和「停下来」，这是给自己省事。

实战三：Docker 里做隔离实验

如果你要让它跑一些不确定安全性的脚本，Docker 方式是最合适的：随便折腾，坏了删容器重来，宿主机只暴露 ~/.hermes 一个目录。把测试目录也挂进去，它就只能碰那一个文件夹。

06踩坑与排错

现象原因与处理
安装脚本跑一半断掉网络中断。重跑一次通常能续上；反复失败就换镜像站域名或换网络。
Windows PowerShell 报语法错确认用的是 iex (irm ...) 括号形式，而不是 irm ... | iex 或 CMD 写法。
装完命令找不到PATH 没更新。重开终端；仍不行就看安装脚本最后的提示，手动加路径。
Docker 里配置不生效挂载路径写错，配置写到了容器里。检查 -v 左右两边是否对应正确。
setup 里没有我能用的模型先确认该文档最新版本支持哪些提供商；不要硬凑，换一个工具或先解决 key。
想从 Hermes 换到 OpenClaw官方有「从 Hermes 迁移」专章，按它的步骤做，别手动搬 json。

07边界

  • 它不是「一次装好就永久稳定」的桌面软件，自托管产品更新频繁，出问题先看官方文档的新版本说明。
  • 它没有 OpenClaw 那么多现成渠道插件。如果你主要诉求是「从微信指挥」，OpenClaw 更合适。
  • 模型是另算的钱。软件免费不等于使用免费。

上一课

07 · OpenClaw

官方文档：hermes-agent.nousresearch.com/docs/zh-Hans
中文镜像入口：hermes-agent.ac.cn（安装命令与官方一致）
四条安装命令均来自官方安装页与官方镜像页；Windows 路径官方标注为早期测试阶段，稳定性以文档当前说明为准。