Hermes Agent 部署教程（新手入门）

本教程基于 Hermes Agent v0.9+，面向零基础新手，手把手带你完成从安装到第一次对话的全过程。

目录

  1. 什么是 Hermes Agent？
  2. 准备事项
  3. 方式一：桌面版安装（推荐新手）
  4. 方式二：命令行安装
  5. 配置模型（让 AI 能回答问题）
  6. 第一次对话
  7. （可选）接入消息平台
  8. 常用命令速查
  9. 常见问题排查

1. 什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的自主 AI Agent，和普通的 AI 聊天工具不同，它有以下特点：

  • 🧠 会学习：能创建和积累"技能"，越用越聪明
  • 🌍 随处运行：可以跑在你的电脑、服务器、甚至云端
  • 💬 多平台接入：支持 Telegram、Discord、飞书、企业微信等 20+ 平台
  • 🔧 内置 60+ 工具：文件操作、网页搜索、代码执行、浏览器控制等

2. 准备事项

在开始之前，请确认以下内容：

项目要求说明
操作系统Windows 10+、macOS 12+、LinuxWSL2 也支持
网络能访问国际互联网需要连接 AI 模型 API
Git可选（命令行安装需要）Windows 用户可跳过
AI 模型 API Key需要至少一种详见第 5 节
⚠️ 重要提示：Hermes Agent 需要连接大语言模型（LLM）才能工作。如果你没有 API Key，可以使用 Nous Portal（免费 OAuth 登录，无需 Key），详见第 5 节。

3. 方式一：桌面版安装（推荐新手）

这是最简单的方式，适合绝大多数用户。

步骤

  1. 打开浏览器，访问官网：

👉 https://hermes-agent.nousresearch.com/

  1. 点击页面上的 Download 按钮，下载对应你系统的安装包：

- Windows：下载 .exe 安装程序

- macOS：下载 .dmg 安装程序

  1. 运行安装包，按提示完成安装（一路"下一步"即可）
  1. 安装完成后，你可以在开始菜单/应用程序中找到 Hermes Desktop 并启动
✅ 桌面版安装后，命令行工具 hermes 也会自动配置好，你可以在终端里直接使用。

4. 方式二：命令行安装

适合喜欢命令行的用户，或者需要在服务器上部署的场景。

Linux / macOS / WSL2

打开终端，执行以下命令：

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

安装完成后，重新加载 Shell 配置：

source ~/.bashrc   # 如果你用 bash
# 或者
source ~/.zshrc    # 如果你用 zsh

Windows（原生，不用 WSL）

以管理员身份打开 PowerShell，执行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
💡 提示：Windows 用户推荐使用 WSL2（Windows Subsystem for Linux），安装体验与 Linux 完全一致，且兼容性更好。

验证安装是否成功

在终端输入：

hermes --version

如果看到版本号（如 v0.9.0），说明安装成功！

5. 配置模型（让 AI 能回答问题）

安装完成后，Hermes 还不能直接回答问题 —— 你需要告诉它使用哪个 AI 模型。

方式 A：最快上手 —— Nous Portal（推荐！）

如果你没有 API Key，这是最好的选择：

hermes setup --portal

执行后会弹出浏览器，完成 OAuth 登录即可。无需任何 API Key，登录后自动配置完成。

✅ Nous Portal 免费套餐已包含 300+ 模型和工具网关（网页搜索、图像生成、TTS 等）

方式 B：使用其他 AI 提供商

如果你已经有 API Key，可以用交互式向导配置：

hermes model

按照提示选择提供商，然后输入 API Key 即可。

#### 常用提供商配置速查表

提供商需要准备的 Key配置方式
Nous Portal无需 Key（OAuth 登录）hermes setup --portal
OpenRouterOPENROUTER_API_KEYhermes model 选择 OpenRouter
DeepSeekDEEPSEEK_API_KEY设置环境变量或 hermes config set
Anthropic (Claude)ANTHROPIC_API_KEYhermes model 选择 Anthropic
OpenAI (GPT)OPENAI_API_KEYhermes model 选择 OpenAI
Google GeminiGOOGLE_API_KEYhermes model 选择 Google
本地 Ollama无需 Key安装 Ollama 后自动识别

#### 手动设置 API Key 示例

# 设置 DeepSeek（举例）
hermes config set DEEPSEEK_API_KEY sk-your-key-here

# 设置 OpenRouter（举例）
hermes config set OPENROUTER_API_KEY sk-or-v1-xxx

# 选择具体模型
hermes config set model deepseek/deepseek-v4-flash
⚠️ 注意事项：
- API Key 会保存在 ~/.hermes/.env 文件中，请注意保护
- 使用本地模型（如 Ollama）需要确保上下文窗口 ≥ 64,000 tokens

6. 第一次对话

配置好模型后，就可以开始和 Hermes 对话了！

启动对话

hermes          # 经典 CLI 界面
# 或者
hermes --tui    # 现代 TUI 界面（支持鼠标，推荐）

验证安装成功

启动后，你应该看到：

  1. 欢迎横幅，显示你选择的模型和提供商
  2. 可以正常输入消息，Hermes 会回复
  3. 可以尝试让 Hermes 执行一些操作，比如：

```

帮我看看当前目录下有什么文件

```

推荐的首次测试提示词

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

或者（中文）：

介绍一下你自己，告诉我你能做什么。

7. （可选）接入消息平台

Hermes Agent 的一个强大功能是可以通过消息平台（Telegram、飞书、企业微信等）和你交互，让你在手机上也能使用 AI Agent。

支持的平台

  • Telegram
  • Discord
  • Slack
  • 飞书（Feishu）
  • 企业微信（WeCom）
  • WhatsApp
  • 微信（通过 iLink Bot 等网关）
  • 更多...

快速配置（以 Telegram 为例）

  1. 找 @BotFather 创建一个 Telegram Bot，获取 Bot Token
  2. 运行配置命令：
hermes gateway setup
  1. 按提示输入 Bot Token，完成配置
  2. 启动网关：
hermes gateway start

飞书接入简要说明

如果你需要接入飞书，需要先完成以下步骤：

  1. 访问飞书开放平台（https://open.feishu.cn/），创建企业自建应用
  2. 启用"机器人"功能
  3. 配置权限（消息读取、消息发送等）
  4. 获取 App ID 和 App Secret
  5. 使用以下命令配置：
hermes gateway setup
# 选择 Feishu，然后输入 App ID 和 App Secret
📚 详细的飞书接入指南，可以参考：https://hermes-agent.nousresearch.com/docs/user-guide/messaging/

8. 常用命令速查

基础命令

命令说明
hermes启动对话（经典模式）
hermes --tui启动对话（TUI 模式，推荐）
hermes --continue / -c恢复上次会话
hermes model切换/配置 AI 模型
hermes setup完整设置向导
hermes doctor诊断配置问题
hermes update更新到最新版本
hermes tools配置工具开关
hermes gateway start启动消息网关
hermes sessions list查看所有会话

对话中的斜杠命令

在对话界面中，可以直接输入以下命令：

命令说明
/help显示所有可用命令
/tools列出可用工具
/model切换模型
/save保存当前对话
/voice on开启语音模式

9. 常见问题排查

hermes: command not found

原因：命令行工具没有加入系统 PATH

解决方法：

# 重新加载 Shell 配置
source ~/.bashrc   # 或 source ~/.zshrc

# 如果还不行，检查 ~/.local/bin 是否在 PATH 中
echo $PATH

启动后 Hermes 不回复 / 报错

原因：模型配置有问题

解决方法（按顺序尝试）：

hermes doctor        # 诊断配置
hermes model         # 重新配置模型
hermes setup         # 重新运行完整设置向导

API Key 报错（401 / Authentication failed）

原因：API Key 错误或者格式不对

解决方法：

  1. 检查 Key 是否复制完整（没有多余空格）
  2. 确认 Key 对应的提供商和模型匹配
  3. 尝试在 hermes model 中重新输入 Key
  4. DeepSeek 用户注意：确认 API Key 格式是 sk- 开头

网关启动后 auxiliary_client 报 401（高级用户）

这是 v0.9.0 中已知的一个 Bug，CLI 模式正常，但网关模式下的辅助模型客户端会报错。

临时解决方案：

  • 暂时使用 CLI 模式（hermes 或 hermes --tui）
  • 或者尝试使用 OpenRouter 中转 Key
  • 关注 GitHub 仓库获取更新：https://github.com/NousResearch/hermes-agent

如何 completely 重新开始？

# 重置配置
rm -rf ~/.hermes

# 然后重新运行设置
hermes setup

附录：文件位置说明

Hermes Agent 的配置文件都存放在用户目录下：

路径说明
~/.hermes/主配置目录
~/.hermes/config.yaml主配置文件
~/.hermes/.envAPI Key 等敏感信息
~/.hermes/sessions/对话历史记录
~/.hermes/skills/自定义技能目录
~/.local/bin/hermes命令行工具位置

总结

完成以上步骤后，你已经成功部署了 Hermes Agent！接下来的探索方向：

如有问题，可以：

  • 查看官方文档：https://hermes-agent.nousresearch.com/docs/
  • 在 GitHub 提 Issue：https://github.com/NousResearch/hermes-agent
  • 加入社区讨论（官网有 Discord/Telegram 链接）

*最后更新：2026 年 6 月 | 基于 Hermes Agent v0.9+*