Hermes Agent CLI 入门指南：从安装到你的第一个 AI 智能体任务
学习目标
学完本教程，你将能够：
- 在你的操作系统上安装 Hermes Agent
- 配置提供商并开始你的第一次对话
- 使用 Hermes Agent 进行交互式聊天和单次查询
- 掌握 Hermes Agent 的关键命令和功能
- 排查常见的安装问题
所需时间： 10–15 分钟
难度： 初级
本篇覆盖哪个版本？ 本教程覆盖 Hermes Agent CLI——在终端中运行的命令行版本。推荐安装器也会自动安装 Hermes Agent 桌面客户端。如果你只需要桌面版，请从官网直接下载。
开始之前
开始前，请确认你具备：
| 要求 | 说明 |
|---|---|
| 操作系统 | macOS 12+、Windows 10/11、Linux（Ubuntu 20.04+、Debian 10+ 等）、或 WSL2 |
| Git | CLI 安装器需要 |
| 网络 | 稳定的互联网连接 |
| 账号 | Nous Portal 账号，或支持的提供商（OpenAI、Anthropic、OpenRouter 等）的 API key |
什么是 Hermes Agent？
Hermes Agent 是 Nous Research 推出的开源 AI 智能体，可在终端、桌面客户端和消息平台上运行。与编程助手不同，Hermes Agent 是通用自主智能体，具有持久记忆、自改进技能和多平台消息网关支持。它兼容 300+ 模型和任意提供商。
什么是 Nous Portal？ Nous Portal 是 Nous Research 的订阅服务，通过一次 OAuth 登录即可使用 300+ 模型和工具网关（网页搜索、图像生成、TTS、云浏览器）。这是上手 Hermes Agent 最快的方式——无需管理 API key。
什么是终端？ 终端（也叫命令行）是一个通过输入命令来操作电脑的窗口，而不是点击按钮。在 Windows 上它叫 PowerShell；在 macOS 上它叫终端。
如何打开终端（逐步操作）
如果你不确定如何打开终端，请按下面你所用系统的步骤操作。
Windows — 打开 PowerShell
- 1点击屏幕左下角的开始按钮（Windows 徽标）。
- 2直接输入
PowerShell。 - 3点击列表中出现的 Windows PowerShell 或终端应用。
- 4如果弹出蓝色的用户账户控制窗口，点击是。
如何粘贴命令： 在 PowerShell 窗口内右键即可粘贴（或按 Ctrl + V）。
下载与安装
选项 A：Hermes Agent 桌面安装器（推荐）
桌面安装器同时安装 CLI 和桌面客户端。从官网下载安装器并运行：
- Windows： 点击 Download for Windows，运行安装程序，按屏幕提示操作。
- macOS： 点击 Download for macOS，打开
.dmg文件，把 Hermes Agent 拖入 Applications 文件夹。 - Linux： 暂不支持桌面安装器，请使用下方选项 B。
安装完成后，在终端中运行 hermes --version 验证 CLI 可用。
选项 B：仅 CLI（全平台）
仅命令行安装，安装器自动处理所有依赖（Python、Node.js、ripgrep、ffmpeg），你只需安装 Git。
Windows 安装
- 1打开 PowerShell（点击开始按钮，输入
PowerShell，点击它）。 - 2复制下面的命令，粘贴到 PowerShell 中，按回车：
irm https://hermes-agent.nousresearch.com/install.ps1 | iex- 1等待安装完成。
- 2完全关闭 PowerShell 后重新打开，验证：
hermes --version如果看到版本号，说明安装成功。
配置提供商
最快路径：Nous Portal
一次订阅覆盖 300+ 模型和工具网关（网页搜索、图像生成、TTS、云浏览器）。在全新安装后：
hermes setup --portal此命令登录 Nous Portal、设置提供商、开启工具网关，一步到位。
其他提供商
如果你已有其他提供商（OpenAI、Anthropic、OpenRouter 等）的 API key，使用设置向导：
hermes setup或交互式配置提供商：
hermes model设置向导提供三种模式：
- 快速设置（Nous Portal） —— 免费 OAuth 登录，无需 API key。推荐快速路径。
- 完整设置 —— 逐个配置每个提供商、工具和选项。
- 空白模式 —— 除运行智能体所必需的最低配置外，一切默认关闭。适合需要完全控制权的用户。
常见提供商配置
| 提供商 | 说明 | 设置方式 |
|---|---|---|
| Nous Portal | 订阅制，零配置 | hermes setup --portal |
| OpenAI | 按量付费 API | hermes model → 选择 OpenAI → 粘贴 API key |
| Anthropic | 按量付费 API | hermes model → 选择 Anthropic → 粘贴 API key |
| OpenRouter | 多模型网关 | hermes model → 选择 OpenRouter → 粘贴 API key |
| 本地（Ollama） | 本地运行模型 | hermes model → 选择 Ollama → 选择本地模型 |
你的第一次对话
第 1 步：启动交互式会话
hermes你会看到 Hermes Agent 的提示符，准备接受你的输入。如果是首次使用，可能需要一点时间初始化会话。
第 2 步：问候
输入一条消息并按回车：
你好！你能做什么？Hermes Agent 会回复它的能力概述。再试试这些：
现在几点？—— Hermes Agent 检查系统时间列出这个目录中的文件—— Hermes Agent 使用文件系统工具搜索关于 AI 智能体的最新新闻—— Hermes Agent 使用网页搜索工具（如果已启用）
第 3 步：单次查询，无需交互模式
hermes chat -q "法国的首都是什么？"这会执行一次查询后退出——适合脚本和自动化。
第 4 步：退出 Hermes Agent
在交互式会话中，输入 /exit 并按回车，或按 Ctrl + C。
常用命令
| 命令 | 作用 |
|---|---|
hermes | 启动交互式会话 |
hermes chat -q "问题" | 运行单次查询后退出 |
hermes setup | 运行设置向导 |
hermes model | 配置提供商和模型 |
hermes doctor | 运行安装诊断 |
hermes desktop | 启动 Hermes Agent 桌面客户端 |
hermes dashboard | 打开网页管理面板 |
hermes proxy | 启动 OpenAI 兼容的本地代理 |
hermes --version | 显示安装版本 |
/exit | 退出交互式会话 |
/help | 显示可用斜杠命令（会话内） |
故障排查
| 问题 | 解决方法 |
|---|---|
hermes: command not found | 安装文件夹不在 PATH 中。重新加载 shell（source ~/.bashrc），或完全重启终端。如果仍然不行，重新安装。 |
git: command not found | 需要 Git。从 git-scm.com（Windows/macOS）安装，或运行 sudo apt install git（Linux）。 |
curl: command not found（Linux） | 运行 sudo apt install curl（Debian/Ubuntu），或对应发行版的等效命令。 |
安装时出现 syntax error | 请确认你运行的是对应平台的正确命令。 |
hermes setup --portal 无法打开浏览器 | 检查网络连接，确认可以访问 hermes-agent.nousresearch.com。 |
| Hermes Agent 找不到模型 | 运行 hermes model 检查提供商配置。如果使用 Nous Portal，重新运行 hermes setup --portal。 |
如何更新
hermes update常见问题
需要付费吗？
Hermes Agent 本身是免费开源的（MIT 许可）。你需要 Nous Portal 订阅、提供商（OpenAI、Anthropic 等）的 API key、或本地模型（Ollama）来驱动智能体。最快的免费路径是 Nous Portal 的免费套餐。
Hermes Agent 可以在没有网络的环境下工作吗？
可以，如果你通过 Ollama 使用本地模型。但某些功能（网页搜索、图像生成、TTS）需要网络。
Hermes Agent 可以使用哪些模型？
Hermes Agent 通过 Nous Portal 支持 300+ 模型，以及通过 OpenAI、Anthropic、OpenRouter、Google、DeepSeek、xAI 等提供商访问的模型，还有 Ollama 本地模型。
Hermes Agent 可以浏览网页吗？
可以，如果网页搜索工具已启用（使用 Nous Portal 或配置了 API key 时默认开启）。
我的数据隐私吗？
Hermes Agent 是开源的，在你的机器上本地运行。你的对话和数据由你选择的 LLM 提供商处理。详情请查阅提供商的数据使用政策。
下一步
- 探索桌面客户端： 运行
hermes desktop启动图形界面。 - 连接消息平台： 用
hermes gateway setup设置 Telegram、Discord、Slack 等平台。 - 创建技能： Hermes Agent 可以把你重复使用的流程保存为技能——只需告诉它保存即可。
- 使用 MCP 服务器： 通过模型上下文协议连接外部工具。
- 阅读完整文档： 访问 hermes-agent.nousresearch.com/docs 查看完整指南。
