Hermes Agent 安装指南

Hermes Agent 安装指南

Hermes Agent 是一款支持长期记忆和自我改进的 AI Agent。它能够跨会话保留上下文，积累技能与经验，适合需要持续协作的场景。

以下为 macOS 和 Windows 用户的安装与基本配置方法。

一、支持的安装环境

Hermes 官方支持以下平台：

• macOS
• Linux
• Windows 的 WSL2
• Android Termux

原生 Windows 不受支持，Windows 用户需先安装 WSL2。

二、macOS 安装步骤

1. 执行安装脚本：

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

2. 刷新 Shell 环境：

   source ~/.zshrc

   （使用 bash 时改为 source ~/.bashrc）

3. 运行初始化和诊断命令：

   hermes setuphermes doctorhermes

安装过程会自动处理所需依赖，包括 Python 3.11、Node.js v22 等。

三、Windows 安装步骤

1. 在 Windows 终端以管理员身份运行：

   wsl --install

   完成后重启电脑。

2. 打开 WSL 中的 Linux 发行版（如 Ubuntu），执行以下命令：

   curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes/main/install.sh | bashsource ~/.bashrchermes setuphermes doctorhermes

在 WSL 环境下，若需长期运行消息平台网关，建议使用 hermes gateway run 而非 hermes gateway start。

四、安装后的初始配置顺序

建议按以下顺序操作：

1. hermes setup —— 执行完整初始化
2. hermes model —— 配置模型
3. hermes doctor —— 进行系统诊断
4. hermes —— 进入 CLI 对话界面

也可分步执行 setup：

• hermes setup model
• hermes setup terminal
• hermes setup gateway
• hermes setup tools
• hermes setup agent

五、模型配置方法

运行以下命令进行模型配置：

hermes model

该命令提供交互式引导，可选择模型提供方并完成认证。后续更换模型可再次执行此命令。

支持的配置方式包括：

• 直接通过菜单选择常用提供方
• 使用 Custom Endpoint（适用于自有 API、中转站或本地模型）：需填写 Base URL、API Key、模型名称及上下文长度
• OpenAI Codex：选择对应选项并按提示完成设备码登录

认证管理可使用 hermes auth 命令。

六、常用命令

安装完成后可执行以下命令进行验证和使用：

• hermes：进入主对话界面
• hermes model：配置或切换模型
• hermes tools：管理工具
• hermes doctor：运行诊断
• hermes status：查看当前状态

在对话界面中输入 / 可查看可用 slash 命令，常用指令包括：

• /new、/reset：新建或重置会话
• /model、/personality：切换模型或人格
• /retry、/undo：重试或撤销
• /compress：压缩上下文
• /usage：查看用量
• /stop：停止生成

七、消息平台配置（以飞书为例）

配置飞书等平台时：

• 使用 hermes gateway setup 进行设置
• 推荐采用 WebSocket 模式，无需公网 webhook
• WSL 环境下长期运行建议使用 hermes gateway run

八、安装建议

安装时建议按以下流程进行：

1. 确认系统环境（macOS 可直接安装，Windows 需使用 WSL2）
2. 执行官方安装脚本
3. 通过 hermes model 完成模型配置
4. 使用 hermes doctor 检查系统状态
5. 确认无误后再配置消息平台、工具等其他功能

此流程可减少配置中的常见问题。