乐于分享
好东西不私藏

Hermes Agent 安装教程:从 0 开始,跑起你的 AI Agent

Hermes Agent 安装教程:从 0 开始,跑起你的 AI Agent

前面我们讲了 OpenClaw。

这次换一个最近同样很值得关注的 Agent:

Hermes Agent。

不讲太多背景。

这篇直接干活:

从 0 开始,把 Hermes 装进自己的电脑。

不会编程也没关系。

跟着复制命令即可。


01|Hermes Agent 是什么?

简单理解:

Hermes Agent 是 Nous Research 推出的开源 AI Agent。

它不只是一个聊天窗口。

Hermes 可以连接不同大模型,使用工具,保存跨会话记忆,创建和改进 Skills,还可以通过 Gateway 接入 Telegram、Discord、Slack、WhatsApp 等平台。官方尤其强调它的“学习闭环”:会从任务经验中沉淀和改进技能。

今天我们的目标很简单:

安装 Hermes → 配置模型 → 成功完成第一次对话

先跑通。

其他功能以后再折腾。


02|安装前准备

Hermes 当前支持:

  • Windows
  • macOS
  • Linux
  • WSL2
  • Android / Termux

Windows 和 macOS 也可以直接使用官方 Hermes Desktop 安装器;不过这篇主要走命令行方式,因为更方便大家理解整个安装过程。

你还需要准备:

  • 一个可用的大模型服务
  • 对应的 API Key 或 OAuth 登录方式

Hermes 支持多种 Provider,例如 Nous Portal、OpenRouter、OpenAI、Anthropic 以及兼容端点。


03|Windows 安装

第一步:打开 PowerShell

按下:

Win + S

搜索:

PowerShell

打开。


第二步:执行安装命令

复制下面这条命令:

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

然后按下:

Enter

这是 Hermes Agent 当前官方提供的原生 Windows PowerShell 安装方式。

接下来安装器会自动处理大量环境配置。

官方文档显示,安装器会负责 Hermes 运行所需的主要组件,包括 Python 环境、Node.js、ripgrep、ffmpeg 等;Windows 安装路径还会根据环境处理 Git。

所以新手一般不需要提前手动安装一堆依赖。

看到终端滚动大量英文,不用紧张。

等待安装完成即可。


04|macOS / Linux / WSL2 安装

打开 Terminal 或终端。

执行:

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

按下回车。

这是官方当前针对 Linux、macOS 和 WSL2 的快速安装方式。

安装完成后,可以重新加载 Shell:

source ~/.bashrc

如果你使用的是 zsh:

source ~/.zshrc

官方安装文档建议安装完成后重新加载 Shell,再启动 Hermes。


05|配置你的 AI 模型

安装完成后,下一步非常关键:

选择 Hermes 使用哪个大模型。

执行:

hermes model

Hermes 会进入交互式模型配置流程。

你可以根据自己已有的账号和 API Key 选择 Provider。官方 Quickstart 将 hermes model 作为模型选择和认证的主要入口。

例如你可能使用:

  • Nous Portal
  • OpenRouter
  • OpenAI
  • Anthropic
  • 其他兼容模型服务

第一次配置时,不要纠结哪个模型“最强”。

建议:

手里哪个能稳定使用,就先用哪个。

先把最基础的聊天跑通。


06|最省事的配置方式

如果你准备使用 Nous Portal,可以直接执行:

hermes setup --portal

按照官方文档,这条命令会通过 OAuth 完成登录,并配置 Nous 作为 Provider,同时接入 Tool Gateway。

对于第一次使用 Hermes 的同学,这是一条比较直接的路径。

当然,你也可以运行完整配置:

hermes setup

然后自己一步一步选择 Provider、Tools 和其他能力。官方当前提供 Quick Setup、Full Setup 和 Blank Slate 等不同初始化思路。


07|启动 Hermes

配置好模型后,直接执行:

hermes

没错。

就这么简单。

官方 Quickstart 中,hermes 就是启动交互式聊天界面的入口。

正常情况下,你会进入 Hermes 的终端交互界面。

这时可以先输入一句:

你好,请介绍一下你自己。

如果能够正常回复:

🎉 恭喜。

你的 Hermes Agent 已经跑起来了。


08|建议立刻做一次检查

安装完成后,执行:

hermes doctor

这个命令非常有用。

它会检查 Hermes 当前配置和环境中可能存在的问题。官方文档也将 hermes doctor 作为主要诊断工具。

如果出现异常,建议先看这里。


09|几个常用命令

启动聊天

hermes

更换模型

hermes model

配置工具

hermes tools

重新运行完整设置

hermes setup

检查问题

hermes doctor

更新 Hermes

hermes update

这些都是官方当前提供的主要 CLI 命令。


10|常见问题

问题一:提示 hermes: command not found

先不要重装。

macOS / Linux 用户可以尝试:

source ~/.bashrc

或者:

source ~/.zshrc

然后重新执行:

hermes

官方安装文档将 Shell 未重新加载或 PATH 配置问题列为 hermes: command not found 的常见原因。

Windows 用户可以:

关闭当前 PowerShell重新打开一个 PowerShell再输入 hermes


问题二:打开 Hermes,但不能正常回复

先执行:

hermes model

重新检查:

  • Provider 是否正确
  • 模型是否可用
  • API Key 是否正确
  • 认证是否成功

官方 Quickstart 将 Provider 认证或模型选择错误列为“空回复、异常回复”的常见原因。


问题三:提示 API Key 没有配置

执行:

hermes model

重新配置 Provider。

官方 Troubleshooting 同样建议在 API Key 缺失时重新运行模型配置。

另外提醒:

不要把自己的 API Key 发到群里。

也不要:

  • 放进公众号截图
  • 上传 GitHub
  • 发给陌生人
  • 写进公开文档

问题四:不知道哪里出了问题

直接运行:

hermes doctor

如果还是不行,可以按照这个顺序排查:

hermes doctorhermes modelhermes setup

这是官方 Quickstart 给出的恢复排查路径的一部分。


11|装完以后可以玩什么?

基础聊天跑通以后,才是真正有意思的部分。


① 让 Hermes 记住你的工作习惯

Hermes 的一个核心特色,就是跨会话记忆和学习机制。

它可以逐渐积累任务经验,并把部分复杂任务经验沉淀为可复用 Skills。

例如你可以尝试让它长期帮助你:

  • 整理论文
  • 汇总实验记录
  • 维护项目进度
  • 处理重复性资料工作
  • 固化自己的工作流程

② 使用 Skills

Hermes 内置 Skills 系统。

你可以把 Skill 简单理解为:

让 Agent 学会一套相对稳定的做事流程。

例如:

论文检索 Skill
实验报告整理 Skill
比赛材料检查 Skill
社团推送生成 Skill

Hermes 还支持浏览和使用 Skills,并可以将安装后的 Skill 作为命令调用。


③ 接入聊天软件

Hermes 可以通过 Gateway 接入多个消息平台。

例如:

  • Telegram
  • Discord
  • Slack
  • WhatsApp
  • Signal
  • Email

官方文档还列出了更多平台。

配置入口:

hermes gateway setup

之后可以检查状态:

hermes gateway status

先提醒一句:

第一次不要同时接五个平台。

一次接一个。

跑通以后再加。


④ 做定时任务

Hermes 支持定时自动化能力。

例如:

  • 每天整理一次学习记录
  • 每周生成项目总结
  • 定期检查某个信息源
  • 自动执行固定任务

官方项目将 Cron Scheduling 作为内置自动化能力之一。


12|OpenClaw 用户还有一个彩蛋

如果你之前已经装过 OpenClaw,Hermes 当前官方提供迁移能力。

可以执行:

hermes claw migrate

还可以先预览:

hermes claw migrate --dry-run

官方说明,Hermes 可以迁移部分 OpenClaw 设置、记忆、用户 Skills、消息配置和受支持的 API Key;首次运行 hermes setup 时也可能检测现有 OpenClaw 配置。

所以之前跟着我们装过 OpenClaw 的同学,可以重点看看这一项。


13|最后提醒:Agent 真的有执行能力

Hermes 不只是一个聊天机器人。

它可以使用:

  • Terminal
  • 文件操作
  • 浏览器
  • Tools
  • Skills
  • 外部服务
  • Messaging Gateway

因此第一次使用时,不要直接给它过高权限。Hermes 官方文档专门提供了安全相关机制和文档,包括命令审批、消息配对以及容器隔离等主题。

建议:

  • 重要文件先备份
  • API Key 不要泄露
  • 不熟悉的命令先确认
  • 不要随便执行来源不明的 Skill
  • 不要一开始就连接所有重要账号
  • 高风险操作保留人工确认

记住一句话:

Agent 越能做事,权限管理就越重要。


写在最后

到这里,你已经完成了:

安装 Hermes配置模型启动 Agent完成第一次对话

其实没有想象中复杂。

接下来真正值得玩的,是:

如何让 Hermes 记住你的工作方式,并逐渐形成属于自己的 Skills。

这也是 Hermes 和普通 AI 聊天工具最不一样的地方之一。

下一篇,我们可以继续做:

《Hermes 装完以后怎么玩?5 个适合大学生的 Agent 实战任务》

SNN 社团

不只聊 AI。

直接把 AI 用起来。