Hermes Agent 保姆级安装教程来了,5 分钟带你上手!

0 阅读6分钟

如果你之前关注过“OpenClaw”这类本地 Agent 工具,那么非常推荐你体验最近爆火的 Hermes Agent 。

从实际使用感受来看,Hermes 整体会更偏成熟、稳定。

它不仅能完成任务,还更强调长期使用中的记忆、自动技能沉淀,适合长期使用的 AI Agent。

这一次,我们实测了 Hermes Agent 的 Windows 原生安装流程。

这篇文章会按照真实操作截图,带大家从 0 开始完成:

Image

01前置工具准备:Git

安装 Hermes Agent 之前,需要先确认电脑里已经安装 Git。

右击 windows 按钮,打开 Windows PowerShell(管理员模式),输入:

git -v

如果终端返回类似下面的内容:

git version 2.53.0.windows.2

说明 Git 已经安装成功,可以继续下一步。

Image

如果提示找不到 git,提示以下问题,则需要先安装 Git。

Image

安装链接:git-scm.com/,下载后一直点击下一步… Hermes 安装流程。

Image

02 Hermes Agent 官方安装命令

确认 Git 正常后,继续在 PowerShell(管理员) 中输入安装命令:

iex
 (
irm
 https://raw.githubusercontent.com/NousResearch/hermes
-agent
/main/scripts/install.ps1)

注:本次使用原生 PowerShell 安装方式,但官方标注为 Early Beta ,官方优先推荐使用 WSL2。

使用 Linux / macOS / WSL2 安装,则使用以下命令:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Image

当终端出现类似下面的提示:

Image

说明 Hermes 的基础 Skill 包已经同步完成。

03 进入 Hermes 初始化配置向导

如果你的电脑之前安装过 OpenClaw,Hermes 可能会检测到已有数据,并提示:

Image

这一步的意思是:Hermes 检测到本地存在 OpenClaw 数据,询问是否查看可导入内容。

如果想先完成 Hermes 安装,可以输入:n;

跳过即可。

04 安装方式推荐 Quick setup

接下来,Hermes 会询问安装方式:

Image

这里推荐选择:1,回车

Quick setup 会优先配置模型供应商、默认模型和消息平台,对于第一次安装体验来说已经够用。

如果你不输入内容,直接按回车,也会默认选择第 1 项。

05 选择模型:DeepSeek

接下来进入模型供应商选择页面。

本次实测选择的是 DeepSeek API,因此在列表中找到:

Image

然后输入:17,按回车确认。

这里的逻辑很简单:Hermes Agent 本身是 Agent 工具,真正负责模型推理的是你配置的模型服务商。

也就是说,Hermes 相当于 Agent 工作台,DeepSeek 则提供底层模型能力。

06 创建 DeepSeek API Key

选择 DeepSeek 之后,Hermes 会要求填写 API Key。

这时需要打开 DeepSeek 开放平台,链接:www.deepseek.com/,点击API 开放平台进入。

Image

创建 API Key 时,可以把名称写成:

Image

这样以后在 DeepSeek 后台就能清楚知道,这个 Key 是专门给 Hermes 使用的。

创建完成后,系统会生成一串以 sk- 开头的 API Key,点击复制,并保存到安全文档中。

Image

这里需要特别提醒:

API Key 只会完整显示一次,后面无法再次查看。

07 填写 API Key 和 Base URL

复制好 DeepSeek API Key 后,回到 PowerShell。

当终端提示:

No DeepSeek API key configured.

DEEPSEEK_API_KEY:

把刚刚复制的 API Key 粘贴进去,然后按回车。

接着会看到 Base URL 配置:

Base URL [https://api.deepseek.com/v1]:

本次实测填写的是:

https://api.deepseek.com

Image

如果你不确定怎么填,可以优先参考 DeepSeek 官方 API 文档中的 base_url 地址。

08 选择模型

接下来,Hermes 会让你选择默认模型。

终端中会出现类似下面的选项:

1. deepseek-chat

2. deepseek-v4-pro

3. deepseek-reasoner

4. deepseek-v4-flash

5. Enter custom model name

6. Skip

本次实测选择的是:2 ,回车。

Image

如果你只是想低成本体验,也可以选择速度更快、成本更低的 chat 模型。

09 选择 Terminal Backend

这里是选择 Hermes 后续执行命令、运行代码的位置,包括本地,Docker,远程,云端等等方式。

对于普通 Windows 用户来说,可以直接保持默认选项(本地),按回车即可。

Image

10 消息平台先跳过

接下来,Hermes 会询问是否连接 Telegram、Discord 等消息平台。

第一次安装建议先跳过,输入:2 ,

Image

后续如果需要把 Hermes 接入 Telegram、Discord、Slack,再单独配置即可。

看到 Installation Complete,说明 Hermes Agent 已经安装完成。

图片

同时,终端会提示:

Restart your terminal for PATH changes to take effect

需要关闭当前 PowerShell,再重新打开一次,让系统环境变量生效。

11 重启 PowerShell

重新打开 PowerShell 后,输入:

hermes

如果看到 Hermes Agent 的大字 Logo,并且页面中显示当前模型、Available Tools、Available Skills 等信息,说明 Hermes 已经成功启动。

Image

这时可以直接输入一句测试:你好,你可以帮我做什么?

如果 Hermes 能正常回复,说明 DeepSeek 模型配置也已经成功。

Image

到这里,Hermes Agent 的终端版已经跑通。

进阶:安装 Hermes Web UI 图形界面

Hermes 官方其实自带了 UI 界面,输入命令:hermes dashboard 即可,但是无法进行对话聊天。

Image

所以我们继续测试了一个 Web UI 图形界面。

Image

需要说明的是:

Hermes Web UI 是社区开源项目,不是 Hermes 官方安装流程的必选项。

它的作用是给 Hermes 增加一个浏览器可视化管理界面,方便查看会话、模型、日志、任务、Skills 等内容。

在 Hermes 终端中输入:

请你查看一下这个仓库,并帮我安装 https://github.com/EKKOLearnAI/hermes-web-ui

Hermes 会自动读取仓库内容,并判断安装方式。

Image

12 启动 Hermes Web UI

安装完成后,执行:

hermes
-web-ui
 
start

启动成功后,终端会显示访问地址:http://localhost:8648 ,按住 Ctrl 点击即可。

如果看到 Hermes Web UI 登录页面,说明图形界面已经启动成功。

Image

注:第一次进入 Web UI,需要输入访问 token,终端会提示 token 的查看方式,按照提示的路径,找到文件位置开打开,将文件中一串 token 复制到浏览器,登录即可。

Image

图片

登录成功后,就可以在浏览器中使用 Hermes Web UI。

13 最 后

如果你有 openclaw,workbuddy,codex 的话,可以直接使用这些工具帮你安装 Hermes Agent。

大家安装工具一开始时不需要懂所有的原理,只需要先按照步骤把环境跑通。只要完成第一次安装,后面再去理解工具能力、使用场景和进阶玩法,就会轻松很多。

欢迎大家持续关注万象 AI 实验室。后续万象 AI 实验室也会继续围绕 Hermes Agent、Codex、AI Agent 工作流、AI 编程工具等方向,持续整理更多可上手的实操教程,帮大家少走弯路,把 AI 真正用到工作里。