什么值得买App下载 App ›
连续签到专享现金活动

Windows安装Hermes Agent全流程指南

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

Hermes 两种启动模式对比

完成上述配置后,即可在 Windows 开始菜单中打开 Ubuntu 终端。若需在本地终端使用,输入 hermes;若需在飞书中使用,输入 hermes gateway 启动服务。相比早期工具,Hermes 的优势在于能在人机协作过程中自动沉淀技能,实现更高级的自动化任务处理。

评论

评论区空态插画

当前文章无评论,是时候发表评论了