🤖HermesBlog
Hermes 官方教程 · 第2篇2026/8/9· Easy Understand Hermes Agent

5 分钟跑通你的第一个 AI 对话

Hermes Agent 官方教程第二篇:快速开始。从安装到第一次对话只要 5 分钟。

5 分钟跑通第一个 AI 对话:水管系统图

5 分钟跑通你的第一个 AI 对话

别急着折腾,先让 Hermes 真正“开口说话”。这篇就是给你准备的最短路径——装好、配好、聊上天,完事。

先看视频?也行

Onchain AI Garage 做了一个完整的安装配置视频教程,跟着画面走更直观。想看的直接去 Hermes Agent Tutorials & Use Cases 播放列表里翻。

装 Hermes,两条路

推荐:桌面安装包(macOS / Windows)

官网下载页 下载 Hermes Desktop 安装包,双击运行,命令行和桌面应用一起装好,省心。

命令行安装(Linux / macOS / WSL2 / Android Termux)

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

Windows 原生的话,在 PowerShell 里跑:

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

装完记得重载一下 shell:

source ~/.bashrc   # 或 source ~/.zshrc

手机 Termux 用户注意:有专门的 Termux 指南,别硬来。

选模型提供商——最关键的一步

跑这个命令,跟着交互一步步选:

hermes model

新手最省事的路:Nous Portal

一个订阅搞定 300+ 模型,还自带 Tool Gateway(联网搜索、生图、TTS、云浏览器)。全新安装直接跑:

hermes setup --portal

一条命令完成登录、设置提供商、开启工具网关,零 API key 配置。

其他常见选择:

提供商 说明 配置方式
Nous Portal 订阅制,零配置 hermes model 里 OAuth 登录
OpenAI Codex 用 ChatGPT/Codex 订阅 hermes model → 选 ChatGPT 订阅
Anthropic Claude 模型 OAuth 登录(需 Max 套餐)或 API key
OpenRouter 多模型路由 填 API key
Fireworks AI OpenAI 兼容 API FIREWORKS_API_KEY

三种安装模式,选对省心

hermes setup 会问你选哪种:

  • 快速安装(Nous Portal):免费 OAuth 登录,不用 API key,自动配好模型和工具。推荐
  • 完整安装:所有提供商、工具、选项都自己过一遍,适合自带 key 的老手。
  • 空白模式:除了最基础的(模型 + 文件操作 + 终端),其他全关。适合想要完全掌控、按需开启的人。之后用 hermes tools 随时开启,hermes skills opt-in --sync 装技能。

铁律:先跑通一次对话

如果 Hermes 连一次正常对话都完不成,就别急着加功能。 先确保一条干净的对话能通,再考虑网关、定时任务、技能、语音这些花活。

验证:真的能聊了

装完配完,直接开聊:

hermes

输入一句“你好”,看它回不回。回了,成了。没回,回去检查 provider 配置——大概率是模型名写错或 key 没生效。

搞定这一步,你的 Hermes 就真正能干活了。接下来想加什么,都是锦上添花。

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › getting-started/quickstart