UUCode Docs

切换深色模式

Hermes（爱马仕）配置教程 ​

本文档用于说明 Hermes 的安装、模型配置与消息通道配置（以飞书为例）。

前置准备 ​

Hermes 官网页面

Windows 安装 ​

1. 打开命令行 ​

  • 可使用 PowerShell
  • 如果遇到权限问题，请以管理员身份运行

2. 执行安装命令 ​

powershell
irm https://res1.hermesagent.org.cn/install.ps1 | iex

Windows 安装 Hermes

3. 校验是否安装成功 ​

powershell
hermes --version

Windows 校验 Hermes 版本

macOS / Linux 安装 ​

在终端执行：

bash
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后可执行：

bash
hermes --version

配置模型 ​

执行模型配置向导：

bash
hermes model

建议先完成基础模型配置，后续再按需细调参数。

Windows Hermes 配置模型

Windows Hermes 使用界面

启动 Hermes ​

bash
hermes

启动成功后即可在终端内交互使用。

Windows Hermes 启动成功

配置消息通道（飞书示例） ​

1. 执行网关配置 ​

bash
hermes gateway setup

根据向导完成飞书机器人或其他通道配置。

Windows Hermes 配置飞书 1

Windows Hermes 配置飞书 2

2. 启动网关 ​

bash
hermes gateway run -vv

网关启动后，就可以通过飞书机器人进行对话。

Windows Hermes 飞书网关运行 1

Windows Hermes 飞书网关运行 2

常用命令 ​

bash
hermes model          # 选择大语言模型提供商和模型
hermes tools          # 配置启用哪些工具
hermes gateway setup  # 设置消息平台
hermes config set     # 单独设置某个配置项
hermes setup          # 再次运行完整设置向导

常见问题 ​

权限不足 ​

  • Windows 下请使用管理员 PowerShell 或管理员 CMD
  • macOS/Linux 下请确认当前用户具备安装与执行权限

命令找不到 ​

  • 先执行 hermes --version 检查是否安装成功
  • 重启终端后再试一次
  • 如仍失败，可重新执行安装脚本