Windows 上部署 Hermes Agent 完整指南 - 让你的 AI 助手在 WSL2 中跑起来

Windows 上部署 Hermes Agent 完整指南 ------ 让你的 AI 助手在 WSL2 中跑起来

前言

Hermes Agent 是一个由 Nous Research 开发的自进化的 AI 代理。简单说，它就像一个能在终端里一直陪伴你的 AI 助手------可以执行任务、写代码、操作浏览器、定时自动化、甚至接入 Telegram/Discord 等平台。

但问题是：Hermes 官方不支持原生 Windows。那 Windows 用户怎么办？

答案是：WSL2（Windows Subsystem for Linux）。通过 WSL2，你可以在 Windows 上无缝运行 Hermes Agent，享受完整的 Linux 用户体验，同时还能调用 Windows 资源（Edge 浏览器、本地文件等）。

本文会手把手带你完成全部部署，从零开始，包教包会。

一、前置准备

1.1 系统要求

Windows 10 版本 2004+（Build 19041+）或 Windows 11
至少 8GB RAM（推荐 16GB）
至少 10GB 可用磁盘空间
稳定的网络连接（用于下载依赖和安装包）

1.2 一句话总结架构

markdown 复制代码

你的 Windows 桌面
    ↓
WSL2（Ubuntu/Linux 环境）← 这就是 Hermes 运行的地方
    ↓
Hermes Agent（CLI 交互、自动化任务、网关服务）

Hermes 跑在 WSL2 的 Linux 里，但可以通过配置操作 Windows 里的 Edge 浏览器。

二、安装 WSL2

如果你已经装了 WSL2，可以直接跳到第三节。

2.1 一键安装

以管理员身份打开 PowerShell 或 CMD，运行：

powershell 复制代码

wsl --install

这条命令会自动：

启用 WSL 功能
安装默认的 Ubuntu 发行版
设置 WSL2 为默认版本

2.2 重启电脑

安装完成后重启，首次启动 Ubuntu 时会要求你设置 Linux 用户名和密码。

2.3 验证安装

bash 复制代码

# 在 Windows 终端或 PowerShell 中
wsl -l -v

# 你应该看到类似输出：
#   NAME      STATE           VERSION
#   Ubuntu    Running         2

如果版本显示为 1，可以手动升级：

powershell 复制代码

wsl --set-version Ubuntu 2

2.4 （可选）更换国内镜像源

对于国内用户，建议将 Ubuntu 的 apt 源更换为国内镜像以提高下载速度：

bash 复制代码

# 备份原始源
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

# 替换为清华源
sudo sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list
sudo sed -i 's/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list

# 更新
sudo apt update && sudo apt upgrade -y

三、安装 Hermes Agent

3.1 一键安装命令

在 WSL2 终端中运行：

bash 复制代码

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

这个安装脚本会帮你自动完成：

安装系统依赖（Python、Node.js、ripgrep、ffmpeg 等）
克隆 Hermes Agent 仓库
创建 Python 虚拟环境（使用 uv 或 pip）
安装所有 Python 依赖
创建全局 hermes 命令
自动配置 LLM 提供商

3.2 重新加载 shell

安装完成后，重新加载配置：

bash 复制代码

source ~/.bashrc

3.3 验证安装

bash 复制代码

hermes doctor

这条命令会诊断环境是否正常。如果看到绿色提示，说明安装成功。

3.4 常见安装问题

问题：下载太慢或超时

如果下载 Hermes 依赖很慢，可以配置 pip 使用国内镜像：

bash 复制代码

# 创建 pip 配置目录
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << 'EOF'
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

# 然后重新运行安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

问题：Python 版本不兼容

Hermes 需要 Python 3.10+。WSL2 默认 Ubuntu 一般自带 Python 3.10+。如果版本太低：

bash 复制代码

sudo apt install python3.11 python3.11-venv python3.11-dev -y

四、配置 LLM 提供商

Hermes 只是一个壳，真正干活需要对接一个 LLM（大语言模型）。

4.1 使用 `hermes model` 命令

bash 复制代码

hermes model

这是一个交互式向导，会引导你选择提供商和模型。

4.2 推荐提供商

场景	推荐	说明
最省心	Nous Portal	免费额度，直接使用
模型最多	OpenRouter	200+ 模型可选，按量付费
已有 OpenAI 账号	OpenAI	直接使用 GPT 系列
已有 Anthropic 账号	Anthropic	使用 Claude 系列
本地运行	Ollama / llama.cpp	用本地 GPU 或 CPU 推理
国产模型	DeepSeek / z.ai GLM	国内访问快，延迟低

4.3 手动配置（推荐国内用户使用 DeepSeek）

如果你希望直接写入 API Key，可以编辑配置文件：

bash 复制代码

hermes config set provider openrouter
hermes config set model deepseek/deepseek-chat

或直接编辑：

bash 复制代码

hermes config set provider deepseek
hermes config set api_key "sk-你的API密钥"

4.4 验证聊天

配置完成后，直接输入 hermes 启动交互式 TUI：

bash 复制代码

hermes

输入任意问题测试响应，如果能正常回答，说明部署成功。

五、进阶：配置 Edge 浏览器支持

这是很多用户需要的功能------让 Hermes 在 WSL 里通过 Windows Edge 浏览器执行网页操作（发文章、填表单、截图等）。

5.1 为什么需要特殊配置

WSL2 和 Windows 是独立的网络命名空间。WSL 里的自动化库（Playwright 等）无法直接操控 Windows 上运行的 Edge 浏览器进程。解决方案是：在 Windows 端启动一个 Playwright 服务器，WSL 通过 HTTP API 远程控制它。

5.2 在 Windows 上安装 Node.js 和 Playwright

在 Windows 上打开 PowerShell（管理员）：

powershell 复制代码

# 创建项目目录
mkdir C:\edge-automation
cd C:\edge-automation

# 初始化项目和安装依赖
npm init -y
npm install playwright

# 安装 Edge 浏览器支持
npx playwright install msedge

5.3 创建自动化服务器脚本

在 C:\edge-automation 目录下创建 server.js：

javascript 复制代码

const express = require('express');
const { chromium } = require('playwright');
const app = express();
app.use(express.json());

let browser, page;

async function startBrowser() {
  browser = await chromium.launch({
    channel: 'msedge',
    headless: false,
  });
  const context = await browser.newContext();
  page = await context.newPage();
  console.log('[SUCCESS] Edge 浏览器已启动');
}

// 导航到 URL
app.post('/navigate', async (req, res) => {
  try {
    await page.goto(req.body.url, { waitUntil: 'networkidle' });
    res.json({ status: 'ok', title: await page.title() });
  } catch (e) { res.status(500).json({ error: e.message }); }
});

// 点击元素
app.post('/click', async (req, res) => {
  try {
    await page.click(req.body.selector);
    res.json({ status: 'ok' });
  } catch (e) { res.status(500).json({ error: e.message }); }
});

// 输入文字
app.post('/fill', async (req, res) => {
  try {
    await page.fill(req.body.selector, req.body.text);
    res.json({ status: 'ok' });
  } catch (e) { res.status(500).json({ error: e.message }); }
});

// 获取页面信息
app.get('/info', async (req, res) => {
  res.json({
    url: page.url(),
    title: await page.title()
  });
});

// 健康检查
app.get('/health', (req, res) => {
  res.json({ status: 'ok', browser: browser ? 'running' : 'stopped' });
});

const PORT = 8080;
startBrowser().then(() => {
  app.listen(PORT, '0.0.0.0', () => {
    console.log(`[INFO] 服务器已启动: http://0.0.0.0:${PORT}`);
  });
});

5.4 启动服务器

powershell 复制代码

cd C:\edge-automation
node server.js

保持这个 PowerShell 窗口打开。服务器启动后，会弹出一个 Edge 浏览器窗口。

5.5 配置 Windows 防火墙

允许 WSL 访问 Windows 的 8080 端口：

powershell 复制代码

netsh advfirewall firewall add rule name="EdgeAutomation" dir=in action=allow protocol=TCP localport=8080

5.6 在 WSL 中测试连接

打开另一个 WSL 终端，获取 Windows 的局域网 IP：

bash 复制代码

# 方法1：通过 resolv.conf
cat /etc/resolv.conf | grep nameserver

# 方法2：通过 ipconfig
ipconfig.exe | grep "IPv4"

然后测试连接（假设 Windows IP 是 192.168.1.100）：

bash 复制代码

curl http://192.168.1.100:8080/health

如果返回 {"status":"ok","browser":"running"}，说明配置成功！

5.7 使用示例

在 Hermes 中可以通过命令行调用：

bash 复制代码

# 打开百度
curl -X POST http://192.168.1.100:8080/navigate \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.baidu.com"}'

# 搜索内容
curl -X POST http://192.168.1.100:8080/fill \
  -H "Content-Type: application/json" \
  -d '{"selector":"#kw","text":"Hermes Agent"}'

# 点击搜索按钮
curl -X POST http://192.168.1.100:8080/click \
  -H "Content-Type: application/json" \
  -d '{"selector":"#su"}'

六、日常使用指南

6.1 常用命令

bash 复制代码

hermes              # 启动交互式 CLI
hermes model        # 切换模型/提供商
hermes setup        # 运行配置向导
hermes gateway      # 启动消息网关（Telegram/Discord 等）
hermes update       # 更新到最新版本
hermes doctor       # 诊断问题
hermes config set   # 修改配置项

6.2 配置自动更新

bash 复制代码

# 创建 cron 任务，每天凌晨检查更新
hermes cron create \
  --schedule "0 3 * * *" \
  --cmd "hermes update" \
  --name "daily-update"

6.3 保存配置到内存

Hermes 会自动在对话中学习你的偏好，但你也可以手动保存重要配置：

bash 复制代码

hermes config set editor "vim"
hermes config set default_model "deepseek/deepseek-chat"

6.4 使用 Skills（技能）

Skills 是 Hermes 最大的亮点之一------它会把做过的复杂任务保存为可复用的技能：

bash 复制代码

# 列出已有技能
hermes skills list

# 使用某个技能
hermes skill run 技能名称

七、故障排查

7.1 hermes 命令找不到

bash 复制代码

# 重新加载 shell 配置
source ~/.bashrc

# 或手动添加 PATH
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

7.2 模型调用失败

bash 复制代码

hermes doctor          # 检查配置
hermes model           # 重新选择模型
hermes config set api_key "新API密钥"  # 检查 API Key

7.3 更新失败

bash 复制代码

# 进入安装目录手动更新
cd ~/.hermes/repo/hermes-agent
git pull
source venv/bin/activate
pip install -e ".[all]"

7.4 WSL 网络问题

如果 WSL 无法连接 Windows 服务：

bash 复制代码

# 重启 WSL（在 Windows PowerShell 中）
wsl --shutdown

# 重启后重新打开 WSL 终端

八、卸载与清理

如果想完全卸载 Hermes：

bash 复制代码

# 删除安装目录
rm -rf ~/.hermes

# 删除全局命令
rm -f ~/.local/bin/hermes

如果想还原 WSL：

powershell 复制代码

# 在 Windows PowerShell 中
wsl --unregister Ubuntu

九、总结

通过 WSL2，Windows 用户可以完整使用 Hermes Agent 的全部功能。整个流程虽然步骤不少，但每一步都有明确的指令，跟着做就行。

部署完成后，你就拥有一个：

✅ 可对话的 AI 助手
✅ 能执行代码和命令的自动化代理
✅ 可定时执行任务的调度器
✅ 能操控 Windows Edge 浏览器的远程控制能力
✅ 支持 Telegram/Discord 等多平台的网关

Hermes Agent 最强大的地方在于它的学习能力------你用得越多，它就越懂你。每次完成任务后它会自动生成技能，下次遇到类似任务就能直接复用。

有任何问题，欢迎在评论区交流！

本文发布于 2026 年 4 月。部署步骤可能随版本更新而变化，请以官方文档为准。

Windows 上部署 Hermes Agent 完整指南 - 让你的 AI 助手在 WSL2 中跑起来