Hermes Agent 安装与快速上手教程

AI 一键解读
复制发给你的 AI，它会自己阅读
请阅读这篇文章（链接：https://yuzaoqie.pages.dev/2026/04/18/hermes-agent/hermes-agent-guide/）并解读全文

1. 一句话介绍

Hermes Agent 是由 Nous Research 开发的强大开源 AI 智能体框架，它能让你在终端直接与 LLM 交互，并赋予 AI 调用本地工具（如文件操作、搜索等）以及连接 飞书 的能力。

2. 系统要求

  • 操作系统： macOS, Linux, Windows (需 WSL2)。
  • 必要依赖： curl, git, Node.js (建议 18+)。
  • API Key： 准备好 OpenAI、Anthropic 或其他兼容 OpenRouter 的 API Key。

3. 一键安装（推荐）

打开你的终端，根据系统复制并粘贴以下命令。

macOS / Linux

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

Windows (必须使用 WSL2)

Windows 用户请不要直接在 PowerShell 运行。先进入 Ubuntu 子系统：

1
2
3
4
5
6
7
8
# 1. 安装 WSL Ubuntu (如果还没装)
wsl --install -d Ubuntu

# 2. 进入 Ubuntu
wsl -d Ubuntu

# 3. 在 Ubuntu 终端内执行安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

4. 使用方式：三步跑起来

安装完成后，别急着聊天，先配置。

第一步：运行初始化向导

在终端执行以下命令开始配置：

1
hermes setup

💡 操作要点：

  • 快速通过： 运行后，大部分基础选项可以直接按 回车 (Enter) 选择默认项。
  • 模型选择： 遇到 Model Selection 界面时，移动光标选择你自己的 AI Model 即可。
  • 网络提示： 若配置过程中出现连接超时，请确保终端已正确开启代理环境。

第二步：配置飞书（Feishu）机器人

在选择通信方式（Communication Method）时，请选择 Feishu：

  1. 获取链接： 终端会即时生成并打印一个专属的 验证链接。
  2. 一键绑定： 点击该链接，系统会自动跳转至飞书授权页面，登录账户并授权。
  3. 自动部署： 绑定完成后，系统将自动配置机器人权限，无需手动填写复杂的 App ID 和 Secret，实现一键部署。

第三步：开始对话

配置完成后，直接输入以下命令进入交互模式：

1
hermes

踩坑提示： 如果进入交互模式后飞书端没有响应，可以尝试运行 hermes status 检查服务运行状态。

5. 常见命令速查表

命令 用途
hermes 进入交互式对话模式
hermes setup 最重要！ 运行全套配置向导
hermes model 切换 LLM 供应商和具体模型
hermes tools 开启或关闭插件（如搜索、文件读写）
hermes gateway 启动网关（连接 Telegram/Discord）
hermes update 一键更新到最新版本
hermes doctor 诊断命令，查看哪里配置错了

6. Windows 特殊说明

请务必记得：不要在 Windows 原生 CMD 或 PowerShell 中运行。 Hermes 的工具链深度依赖类 Unix 环境，所有操作请严格在 WSL2 (Ubuntu) 中进行。如果你发现文件无法读取，请确认文件是否放在了 \\wsl$\Ubuntu\... 路径下。