Windows上部署Hermes Agent的完整指南
我要評論前言
Hermes Agent 是一個由 Nous Research 開發(fā)的自進化的 AI 代理。簡單說，它就像一個能在終端里一直陪伴你的 AI 助手——可以執(zhí)行任務(wù)、寫代碼、操作瀏覽器、定時自動化、甚至接入 Telegram/Discord 等平臺。
但問題是：Hermes 官方不支持原生 Windows。那 Windows 用戶怎么辦？
答案是：WSL2（Windows Subsystem for Linux）。通過 WSL2，你可以在 Windows 上無縫運行 Hermes Agent，享受完整的 Linux 用戶體驗，同時還能調(diào)用 Windows 資源（Edge 瀏覽器、本地文件等）。
本文會手把手帶你完成全部部署，從零開始，包教包會。
一、前置準(zhǔn)備
1.1 系統(tǒng)要求
- Windows 10 版本 2004+（Build 19041+）或 Windows 11
- 至少 8GB RAM（推薦 16GB）
- 至少 10GB 可用磁盤空間
- 穩(wěn)定的網(wǎng)絡(luò)連接（用于下載依賴和安裝包）
1.2 一句話總結(jié)架構(gòu)
你的 Windows 桌面
↓
WSL2（Ubuntu/Linux 環(huán)境）← 這就是 Hermes 運行的地方
↓
Hermes Agent（CLI 交互、自動化任務(wù)、網(wǎng)關(guān)服務(wù)）Hermes 跑在 WSL2 的 Linux 里，但可以通過配置操作 Windows 里的 Edge 瀏覽器。
二、安裝 WSL2
如果你已經(jīng)裝了 WSL2，可以直接跳到第三節(jié)。
2.1 一鍵安裝
以管理員身份打開 PowerShell 或 CMD，運行：
wsl --install
這條命令會自動：
- 啟用 WSL 功能
- 安裝默認(rèn)的 Ubuntu 發(fā)行版
- 設(shè)置 WSL2 為默認(rèn)版本
2.2 重啟電腦
安裝完成后重啟，首次啟動 Ubuntu 時會要求你設(shè)置 Linux 用戶名和密碼。
2.3 驗證安裝
# 在 Windows 終端或 PowerShell 中 wsl -l -v # 你應(yīng)該看到類似輸出： # NAME STATE VERSION # Ubuntu Running 2
如果版本顯示為 1，可以手動升級：
wsl --set-version Ubuntu 2
2.4 （可選）更換國內(nèi)鏡像源
對于國內(nèi)用戶，建議將 Ubuntu 的 apt 源更換為國內(nèi)鏡像以提高下載速度：
# 備份原始源 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 終端中運行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
這個安裝腳本會幫你自動完成：
- 安裝系統(tǒng)依賴（Python、Node.js、ripgrep、ffmpeg 等）
- 克隆 Hermes Agent 倉庫
- 創(chuàng)建 Python 虛擬環(huán)境（使用 uv 或 pip）
- 安裝所有 Python 依賴
- 創(chuàng)建全局
hermes命令 - 自動配置 LLM 提供商
3.2 重新加載 shell
安裝完成后，重新加載配置：
source ~/.bashrc
3.3 驗證安裝
hermes doctor
這條命令會診斷環(huán)境是否正常。如果看到綠色提示，說明安裝成功。
3.4 常見安裝問題
問題：下載太慢或超時
如果下載 Hermes 依賴很慢，可以配置 pip 使用國內(nèi)鏡像：
# 創(chuàng)建 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 默認(rèn) Ubuntu 一般自帶 Python 3.10+。如果版本太低：
sudo apt install python3.11 python3.11-venv python3.11-dev -y
四、配置 LLM 提供商
Hermes 只是一個殼，真正干活需要對接一個 LLM（大語言模型）。
4.1 使用hermes model命令
hermes model
這是一個交互式向?qū)?，會引?dǎo)你選擇提供商和模型。
4.2 推薦提供商
| 場景 | 推薦 | 說明 |
|---|---|---|
| 最省心 | Nous Portal | 免費額度，直接使用 |
| 模型最多 | OpenRouter | 200+ 模型可選，按量付費 |
| 已有 OpenAI 賬號 | OpenAI | 直接使用 GPT 系列 |
| 已有 Anthropic 賬號 | Anthropic | 使用 Claude 系列 |
| 本地運行 | Ollama / llama.cpp | 用本地 GPU 或 CPU 推理 |
| 國產(chǎn)模型 | DeepSeek / z.ai GLM | 國內(nèi)訪問快，延遲低 |
4.3 手動配置（推薦國內(nèi)用戶使用 DeepSeek）
如果你希望直接寫入 API Key，可以編輯配置文件：
hermes config set provider openrouter hermes config set model deepseek/deepseek-chat
或直接編輯：
hermes config set provider deepseek hermes config set api_key "sk-你的API密鑰"
4.4 驗證聊天
配置完成后，直接輸入 hermes 啟動交互式 TUI：
hermes
輸入任意問題測試響應(yīng)，如果能正?；卮?，說明部署成功。
五、進階：配置 Edge 瀏覽器支持
這是很多用戶需要的功能——讓 Hermes 在 WSL 里通過 Windows Edge 瀏覽器執(zhí)行網(wǎng)頁操作（發(fā)文章、填表單、截圖等）。
5.1 為什么需要特殊配置
WSL2 和 Windows 是獨立的網(wǎng)絡(luò)命名空間。WSL 里的自動化庫（Playwright 等）無法直接操控 Windows 上運行的 Edge 瀏覽器進程。解決方案是：在 Windows 端啟動一個 Playwright 服務(wù)器，WSL 通過 HTTP API 遠(yuǎn)程控制它。
5.2 在 Windows 上安裝 Node.js 和 Playwright
在 Windows 上打開 PowerShell（管理員）：
# 創(chuàng)建項目目錄 mkdir C:\edge-automation cd C:\edge-automation # 初始化項目和安裝依賴 npm init -y npm install playwright # 安裝 Edge 瀏覽器支持 npx playwright install msedge
5.3 創(chuàng)建自動化服務(wù)器腳本
在 C:\edge-automation 目錄下創(chuàng)建 server.js：
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 瀏覽器已啟動');
}
// 導(dǎo)航到 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] 服務(wù)器已啟動: http://0.0.0.0:${PORT}`);
});
});5.4 啟動服務(wù)器
cd C:\edge-automation node server.js
保持這個 PowerShell 窗口打開。服務(wù)器啟動后，會彈出一個 Edge 瀏覽器窗口。
5.5 配置 Windows 防火墻
允許 WSL 訪問 Windows 的 8080 端口：
netsh advfirewall firewall add rule name="EdgeAutomation" dir=in action=allow protocol=TCP localport=8080
5.6 在 WSL 中測試連接
打開另一個 WSL 終端，獲取 Windows 的局域網(wǎng) IP：
# 方法1：通過 resolv.conf cat /etc/resolv.conf | grep nameserver # 方法2：通過 ipconfig ipconfig.exe | grep "IPv4"
然后測試連接（假設(shè) Windows IP 是 192.168.1.100）：
curl http://192.168.1.100:8080/health
如果返回 {"status":"ok","browser":"running"}，說明配置成功！
5.7 使用示例
在 Hermes 中可以通過命令行調(diào)用：
# 打開百度
curl -X POST http://192.168.1.100:8080/navigate \
-H "Content-Type: application/json" \
-d '{"url":"https://www.baidu.com"}'
# 搜索內(nèi)容
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 常用命令
hermes # 啟動交互式 CLI hermes model # 切換模型/提供商 hermes setup # 運行配置向?qū)? hermes gateway # 啟動消息網(wǎng)關(guān)（Telegram/Discord 等） hermes update # 更新到最新版本 hermes doctor # 診斷問題 hermes config set # 修改配置項
6.2 配置自動更新
# 創(chuàng)建 cron 任務(wù)，每天凌晨檢查更新 hermes cron create \ --schedule "0 3 * * *" \ --cmd "hermes update" \ --name "daily-update"
6.3 保存配置到內(nèi)存
Hermes 會自動在對話中學(xué)習(xí)你的偏好，但你也可以手動保存重要配置：
hermes config set editor "vim" hermes config set default_model "deepseek/deepseek-chat"
6.4 使用 Skills（技能）
Skills 是 Hermes 最大的亮點之一——它會把做過的復(fù)雜任務(wù)保存為可復(fù)用的技能：
# 列出已有技能 hermes skills list # 使用某個技能 hermes skill run 技能名稱
七、故障排查
7.1 hermes 命令找不到
# 重新加載 shell 配置 source ~/.bashrc # 或手動添加 PATH export PATH="$HOME/.local/bin:$PATH" echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
7.2 模型調(diào)用失敗
hermes doctor # 檢查配置 hermes model # 重新選擇模型 hermes config set api_key "新API密鑰" # 檢查 API Key
7.3 更新失敗
# 進入安裝目錄手動更新 cd ~/.hermes/repo/hermes-agent git pull source venv/bin/activate pip install -e ".[all]"
7.4 WSL 網(wǎng)絡(luò)問題
如果 WSL 無法連接 Windows 服務(wù)：
# 重啟 WSL（在 Windows PowerShell 中） wsl --shutdown # 重啟后重新打開 WSL 終端
八、卸載與清理
如果想完全卸載 Hermes：
# 刪除安裝目錄 rm -rf ~/.hermes # 刪除全局命令 rm -f ~/.local/bin/hermes
如果想還原 WSL：
# 在 Windows PowerShell 中 wsl --unregister Ubuntu
九、總結(jié)
通過 WSL2，Windows 用戶可以完整使用 Hermes Agent 的全部功能。整個流程雖然步驟不少，但每一步都有明確的指令，跟著做就行。
部署完成后，你就擁有一個：
- ? 可對話的 AI 助手
- ? 能執(zhí)行代碼和命令的自動化代理
- ? 可定時執(zhí)行任務(wù)的調(diào)度器
- ? 能操控 Windows Edge 瀏覽器的遠(yuǎn)程控制能力
- ? 支持 Telegram/Discord 等多平臺的網(wǎng)關(guān)
Hermes Agent 最強大的地方在于它的學(xué)習(xí)能力——你用得越多，它就越懂你。每次完成任務(wù)后它會自動生成技能，下次遇到類似任務(wù)就能直接復(fù)用。
以上就是Windows上部署Hermes Agent的完整指南的詳細(xì)內(nèi)容，更多關(guān)于Windows部署Hermes Agent的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Docker 部署 Hermes Agent 完整實戰(zhàn)指南(Windows / Linux 通用)
本文將詳細(xì)介紹如何通過 Docker 快速部署 Hermes Agent，部署前先為大家提供 Docker 一鍵安裝與鏡像加速方案，適配絕大多數(shù)場景，新手也能輕松上手,感興趣的朋友跟隨小編一2026-04-24
Windows上部署Hermes-Agent的實現(xiàn)步驟
本文詳細(xì)介紹了如何在Windows系統(tǒng)上部署和使用Hermes-Agent,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一2026-04-23
Windows本地部署Hermes Agent的完整教程:一鍵安裝腳本與避坑指南
本文將為您提供一份保姆級的 Hermes安裝 教程,無論您是 AI 開發(fā)者還是效率工具愛好者，只需通過簡單的一鍵腳本，即可在 Windows 環(huán)境下快速部署 Hermes Agent,本文還總結(jié)了2026-04-14
