Hermes 安装与 OmniProxy 配置

Hermes 是一个能保留对话和任务经验的助手，做过的事情可以整理成以后继续使用的技能。它还能通过同一个 Gateway 接入 Telegram、Discord、Slack、WhatsApp、Signal 和终端；Gateway 可以理解为统一接收和转发消息的入口。你可以从常用的聊天工具里交给它代码审查、事故记录或客户材料，再让它回到仓库里继续处理。

安装前准备

先根据电脑系统选择安装方式。macOS 和 Windows 可以直接使用带窗口的安装包；Linux、macOS 和 WSL2 可以使用终端脚本。WSL2 是在 Windows 中运行 Linux 环境的功能。Android 手机上的 Termux 和 Docker 也有各自的装法，这篇只介绍普通电脑上的安装。

想要窗口

macOS、Windows

• macOS：打开 DMG
• Windows：打开安装包
• 把应用放进系统

只要终端

Linux、macOS、WSL2

• 一条 install.sh
• Windows 用 install.ps1
• 装完输入 hermes

先不要用

pip、brew、AUR

• 官方不支持这些装法
• 装完也难以更新
• 改用左边两种

开始前准备一台 macOS、Windows 或 Linux 电脑，并确认它能打开终端、访问 GitHub。如果准备使用移动硬盘安装，也要先连接硬盘，并确认里面有足够空间。

安装并首次启动

想要一个窗口

进入 Hermes 官网的下载区，下载与你的系统对应的安装包。安装包已经包含运行环境，第一次打开时不需要在电脑上现编译。

• macOS：打开 DMG，把 Hermes.app 放进「应用程序」。DMG 是 macOS 常用的安装镜像文件。这个安装包只支持 Apple 芯片，Intel Mac 不在支持范围内。
• Windows：用 Windows 的应用安装程序打开 .appinstaller。它安装的是带签名的 MSIX，也就是 Windows 使用的一种应用安装包。
• Linux：桌面安装包是 macOS 和 Windows 的。Linux 用下面的终端命令，装好后可以运行 hermes desktop。

只要终端

如果使用 Linux、macOS 或 WSL2，请在终端执行：

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

使用 Windows 自带的 PowerShell 时执行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装器会下载 Hermes 的代码和运行所需的程序。如果中途下载中断，重新执行同一条命令即可。安装完成后，先关掉当前终端，再打开一个新窗口并输入：

hermes

看到 Hermes 的提示，说明命令已经可以使用。接着可以运行 hermes doctor；它是一项安装检查，会告诉你当前还缺少什么。

程序放在移动硬盘

2026 年 10 月 9 日，Hermes Agent v0.21.6 已在一台 Mac 上安装到移动硬盘。程序位于 /Volumes/AItools/tools/hermes-agent，启动命令位于 ~/.local/bin/hermes，配置和对话仍保存在 ~/.hermes。

如果你的硬盘名称不同，请把 --dir 后面的路径改成自己的文件夹。运行 Hermes 时，这块硬盘必须保持连接。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

程序

移动硬盘

• tools/hermes-agent
• 代码放在这里

命令

~/.local/bin/hermes

• 终端里输入 hermes
• 新开窗口后生效

配置和对话

~/.hermes

• config.yaml 在这里
• 拔掉硬盘前先退出

从 OmniProxy 取得连接参数

Hermes 在这里连接的是 OmniProxy，不是直接连接 Grok 或 Gemini。Grok 和 Gemini 的服务地址配置在 OmniProxy 里，不要把它们直接填进 Hermes。

你的电脑

Hermes

→

本机网关

OmniProxy

• 地址写到 /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

模型 ID 就是接口用来识别模型的准确名称。两个模型分别使用以下名字：

• Grok 填 grok-4.7。xAI 的接口是 https://api.x.ai/v1，聊天请求走 /v1/chat/completions。参见 Grok 模型文档。
• Gemini 填 gemini-3.8-flash。Google 的 OpenAI 兼容接口是 https://generativelanguage.googleapis.com/v1beta/openai/。参见 Gemini 的 OpenAI 兼容说明。

如果要在 Hermes 中改用 Gemini，只需把模型名换成 gemini-3.8-flash，接口地址仍然填写 OmniProxy 的地址。

从 OmniProxy 复制接口地址和密钥，再填入对应的模型 ID：

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL 是 Hermes 发送请求的接口地址，这里要以 /v1 结束。API Key 是 OmniProxy 发给 Hermes 的密钥，请替换成你自己的内容，不要放到公开页面。

如果本机 OmniProxy 没有要求密钥，API Key 可以留空；只要地址能被其他人访问，就应填写密钥。还要确认这个地址能从 Hermes 所在的环境访问。Hermes 和 OmniProxy 都在同一台电脑上时，可以使用本机地址。

填写工具配置

先退出正在进行的聊天，然后在终端执行：

hermes model

选择 Custom endpoint (self-hosted / VLLM / etc.)。Custom endpoint 是自定义接口，表示让 Hermes 连接你指定的服务地址，而不是使用预设来源。

向导会依次询问接口地址、密钥和模型名，按上一节的三项填写。想使用 Gemini 时，模型名填 gemini-3.8-flash。

也可以直接编辑 ~/.hermes/config.yaml。YAML 是一种用缩进表示配置关系的文本格式。下面是 Grok 的写法：

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

使用 Gemini 时，把 default 换成 gemini-3.8-flash，其余三项不变：

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

保存后，重新运行 hermes，再开始聊天。已经打开的会话中，/model 只能在已经保存的来源之间切换，不能用来新增这条配置。

验证一个真实任务

1

hermes doctor

• 安装检查通过

2

发一句短话

• 看到 Hermes 的回复

3

打开调用记录

• 核对模型名

1. 运行 hermes doctor，检查安装是否完整。
2. 运行 hermes，让它用一句话说明自己能做什么。你应该看到一段回复。
3. 打开 OmniProxy 的调用记录，确认这次请求来自 Hermes，并检查模型名是不是 grok-4.7 或 gemini-3.8-flash。

只看到向导保存成功，或者接口返回成功，还不能说明 Hermes 已经能替你完成任务。调用记录中的模型名必须与填写的内容一致。

如果想在浏览器中聊天，可以在本机执行：

hermes dashboard --no-open --host 127.0.0.1 --port 9119

然后打开 http://127.0.0.1:9119。这个地址只在当前这台电脑上有效。

常见错误

• 输入 hermes 提示找不到命令：先关掉终端，再打开一个新窗口。仍然找不到时，确认 ~/.local/bin 已在 PATH 里；PATH 是系统查找命令所在目录的位置列表。Windows 则确认安装器写入的启动目录在 PATH 里。
• 安装下载到一半断开：重新执行同一条安装命令，已经下载的部分会接着使用。
• Hermes 没有回复，或提示连不上：确认 OmniProxy 正在运行，并检查 Base URL 是否以 /v1 结束。如果 Hermes 运行在 Docker 里，而 OmniProxy 在宿主机上，不要使用只在容器内部有效的 127.0.0.1。
• 提示密钥错误：更新 OmniProxy 的密钥，再修改 config.yaml 里的 api_key。xAI 或 Google 的密钥属于 OmniProxy 的供应商设置，不要填到 Hermes 的这一栏。
• 提示没有这个模型：打开 OmniProxy 当前的模型列表，把 grok-4.7 或 gemini-3.8-flash 按列表中的写法原样复制。
• 回复了，但做不了读文件、执行命令这类事：换用 OmniProxy 中另一个具备这些能力的模型，再新开一次 Hermes。
• 程序放在移动硬盘上，拔掉硬盘后 hermes doctor 报存储错误：先重新连接那块硬盘。不要在硬盘未连接时让 Hermes 另写一套配置。

官方参考

安装步骤见 Hermes 安装文档 和 平台支持。Custom endpoint 的配置见 Hermes Provider 文档。模型 ID 分别见 Grok 模型文档 和 Gemini 的 OpenAI 兼容说明。

macOS 上的安装已在 2026-10-09 使用 Hermes Agent v0.21.6 走完。grok-4.7 和 gemini-3.8-flash 是当天 xAI 与 Google 文档中的标准模型 ID。实际填写时，请以 OmniProxy 里显示的名字为准。

用你自己的 OmniProxy 配置替换每个占位符。不要发布真实密钥。

保存成功或 HTTP 200 不单独等同完整 Agent 兼容。请在 OmniProxy 调用记录中确认来源和模型。

官方来源 · Hermes ↗