Windows安装Hermes Agent全流程指南
Hermes Agent 是一款基于 Linux 环境运行的 AI Agent 工具,具备持久记忆、技能系统集成及多工具调用能力。在 Windows 系统上使用时,需通过 WSL2(Windows Subsystem for Linux)搭建 Linux 运行环境。本文将详细介绍从环境准备到飞书对接的完整安装与配置流程,并梳理关键操作节点与避坑指南。
01前置准备与 WSL2 安装
- 安装 WSL2
以管理员身份打开 Windows 终端或命令提示符,输入命令wsl --install进行安装。安装完成后需重启电脑。 - 确认 WSL 状态
重启后再次打开终端,输入wsl --status确认默认版本为 WSL2,这是 Hermes 运行的必要环境。输入wsl --list --online可查看可用的 Linux 发行版。 - 安装 Ubuntu
执行安装命令(通常建议安装指定版本,如 Ubuntu 20.04 或 22.04)。安装过程中会弹出 WSL 图形界面窗口,该窗口可关闭,所有配置均在命令行中完成。
02Ubuntu 初始化与换源
首次启动 Ubuntu 时,系统将要求设置用户名和密码。在此过程中需注意:用户名必须全部为小写字母,包含大写将导致报错;输入密码时屏幕不会显示任何字符,属于正常现象,输入完毕回车即可。完成初始化后,建议将软件源替换为国内镜像(如阿里云),以提升后续下载速度并确保稳定性。
- 备份原源文件
执行命令备份原有的源配置文件。 - 更换镜像源
编辑源列表文件,将默认源地址替换为国内镜像源地址。 - 更新系统
执行更新命令,使配置生效并升级系统软件包。
03环境依赖与 Hermes 安装
在安装 Hermes 之前,需先配置必要的工具环境。执行官方提供的依赖安装命令,安装构建工具及运行库。这一步速度较快,完成后即可开始 Hermes 的主体安装。
- 安装构建工具
输入安装命令,等待系统自动下载并安装 Python、Git 等基础依赖。 - 执行 Hermes 安装
运行官方提供的安装脚本。在“built tools installed”步骤,系统可能需要较长时间(视网络情况约半小时),此时界面看似卡顿,若无红色报错信息请勿中断。 - 配置大模型
安装完成后,根据提示选择或输入所用的大模型(如 DeepSeek)。需填入对应的 API Key 和 Base URL,若 Base URL 未知可查询对应大模型的官方文档。
04飞书对接与使用
Hermes 支持通过网关接入通讯工具。以飞书为例,需先在飞书开放平台创建应用获取凭证,随后在 Ubuntu 命令行中运行网关配置命令进行绑定。
- 创建飞书应用
访问飞书机器人创建链接,填写应用名称和头像。创建成功后获取 App ID 和 App Secret。 - 启动网关配置
在 Ubuntu 命令行中输入hermes gateway setup,选择飞书作为连接平台。 - 填写凭证与配对
输入 App ID 和 App Secret,选择国内版及长链连接模式。最后通过飞书应用发送消息获取配对码,在命令行中完成配对。
| 使用场景 | 启动命令 | 交互方式 |
|---|---|---|
| 命令行直接交互 | hermes | 在 Ubuntu 终端直接输入指令与对话 |
| 通讯工具(飞书)交互 | hermes gateway | 通过飞书应用与机器人对话 |
Hermes 两种启动模式对比
完成上述配置后,即可在 Windows 开始菜单中打开 Ubuntu 终端。若需在本地终端使用,输入
hermes;若需在飞书中使用,输入 hermes gateway 启动服务。相比早期工具,Hermes 的优势在于能在人机协作过程中自动沉淀技能,实现更高级的自动化任务处理。
当前文章无评论,是时候发表评论了