Hermes Agent安装教程：Windows系统避坑指南 ​

Windows 用户安装 Hermes Agent 的完整流程，照着做基本不会翻车。

一、环境准备：安装 WSL2 ​

Step 1：安装 WSL ​

以管理员身份打开 PowerShell：

wsl --install

执行完成后必须重启电脑。

Step 2：查看可安装系统 ​

wsl.exe --list --online

建议选择 Ubuntu-20.04：

wsl.exe --install Ubuntu-20.04

查看当前版本：

wsl.exe --list --verbose

⚠️ 重点避坑：网络模式设置 ​

必须选择 Mirrored 模式！

同时开启：

• 关闭防火墙（临时）
• 开启 localhost 转发
• 打开自动代理

设置完重启电脑。

二、在 WSL2 中安装 Hermes Agent ​

Step 1：一键安装 ​

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

脚本自动完成：

• 安装 uv（Python 包管理器）
• 安装 Python 3.11+
• 克隆 Hermes Agent 仓库
• 创建虚拟环境
• 安装依赖
• 将 hermes 命令添加到 PATH

Step 2：激活环境 ​

# Bash 用户
source ~/.bashrc

# Zsh 用户
source ~/.zshrc

Step 3：验证安装 ​

hermes --version

看到 hermes x.x.x 输出即成功。

三、配置 AI 模型 ​

启动配置向导：

hermes setup

选择 Quick setup（推荐）。

在交互式界面中：

1. 选择模型提供商（OpenAI、Anthropic、OpenRouter 或国内大模型）
2. 输入 API Key
3. 选择默认模型（推荐 minimax-m2.5，便宜）

四、接入聊天工具（飞书示例） ​

1. 创建飞书机器人 ​

• 打开飞书 → 群聊或开发者后台
• 创建自定义机器人或企业自建应用
• 获取 App ID、App Secret 或 Webhook 地址

2. 配置机器人权限 ​

开启：

• 接收消息
• 发送消息
• 机器人交互权限

3. 在 Hermes 中配置飞书 ​

hermes config set FEISHU_APP_ID 你的AppID
hermes config set FEISHU_APP_SECRET 你的Secret

# 如果使用 Webhook
hermes config set FEISHU_WEBHOOK 你的Webhook地址

4. 启动飞书网关 ​

hermes gateway feishu

5. 测试 ​

在飞书中找到机器人，发送消息，正常回复即成功。

避坑提示 ​

常见问题 ​

Q：想 24 小时运行怎么办？

买个便宜的阿里云、腾讯云 VPS，在服务器上安装，操作同理。

总结 ​

关键点：WSL2 网络模式选 Mirrored，其他按步骤来即可。

关键词：Hermes Agent安装, WSL2, Windows安装, 飞书机器人, Mirrored模式, Ubuntu安装