前言

Hermes Agent 是一个强大的 AI 智能体框架，支持软件开发、办公自动化、多媒体生成、智能家居控制等海量能力。今天给大家带来一份完整的 Windows 安装教程，手把手带你从零配置好 Hermes Agent！

⚠️ 注意：需要科学上网！！！

---

第一步：以管理员身份运行 PowerShell

1. 右键点击 开始菜单 → 选择 PowerShell
2. 或按 Win + S 搜索 PowerShell，右键选择 "以管理员身份运行"

⚠️ 注意：必须使用管理员权限，否则 WSL2 安装会失败！

---

第二步：安装 WSL2

在打开的 PowerShell 窗口中，输入以下命令：

wsl --install

安装完成后：

• 系统会自动下载并安装 Ubuntu Linux 子系统
• 首次启动会要求你创建 Linux 用户名和密码（与 Windows 密码无关）
• 密码输入时屏幕无显示，属正常现象，输入完按回车即可

---

第三步：替换国内 apt 源（加速下载）

由于 Ubuntu 默认源在海外，替换为国内镜像可大幅提升下载速度！

依次执行以下命令：

# 1. 备份原有源
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
 
# 2. 替换为阿里云镜像
sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's|http://security.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources

---

第四步：更新软件包索引

sudo apt update && apt upgrade -y

这一步让系统知道软件包列表已经更新，准备好安装新软件了。

---

第五步：安装前置依赖软件

执行命令：

sudo apt install -y git curl nodejs npm

安装过程会拉取大量依赖库（ffmpeg、ripgrep 等），耐心等待即可。

---

第六步：执行官方一键安装脚本

先替换 npm 源（国内加速）：

npm config set registry https://registry.npmmirror.com

然后执行官方安装脚本（时间比较长）：

# 这个2都可以，但是都需要科学上网
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

---

第七步：配置Hermes Agent（0.13版）

1、选择 Quick setup（快速配置），或者hermes setup

2、选择模型（我有千问api-key）

3、填写api-key （不会显示，像密码一样）

4、这个我们需要修改为国内的 Base URL （在对应供应商的api配置参考文件内查找）

5、选择使用的的模型名字

6、默认即可

7、设置消息功能

8、现在消息端（推荐飞书，空格是选择✅，回车不是）

9、推荐飞书（一键配置或者扫码）

10、这里

11、打开飞书，找到飞书助手，将网址发送给他

12、然后点开这个

13、立即创建

14、打开应用

15、消息授权（默认即可）

16、默认

17、回车，跳过即可

18、将网关默认启动

19、选择网关模式

• 第一个是开机不自动启 ，需要手动启动，适合个人电脑
• 第二个是系统服务开机自启，适合24小时在线

20、启动服务（ 如果失败也可手动启动网关hermes gateway）

21、在终端驶入这个进行配对，然后就可以对话啦

---

🎉 你可以做什么？

安装完成后，Hermes Agent 几乎无所不能：

能力类别	具体功能
🖥️ 软件开发	代码审查、GitHub 集成、PR 管理、子代理开发
📄 办公效率	Notion、Obsidian、Google Workspace、PDF 处理
🎨 多媒体生成	音频生成、GIF 搜索、YouTube 内容处理
📚 学术研究	arXiv 论文搜索、博客监控、预测市场查询
🎮 游戏娱乐	Minecraft 服务器管理、Pokemon 模拟器
🏠 智能家居	OpenHue 灯光控制
📱 社交媒体	X/Twitter 发帖、搜索

---

📌 完整命令速查表

# 1. 安装 WSL2
wsl --install

# 2. 替换 apt 源
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's|http://security.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list.d/ubuntu.sources

# 3. 更新
sudo apt update

# 4. 安装前置软件
sudo apt install -y git curl nodejs npm

# 5. 替换 npm 源
npm config set registry https://registry.npmmirror.com

# 6. 执行官方安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 7. 配置
hermes setup

# 8. 启动网关
hermes gateway