Windows上部署Hermes Agent的完整指南
前言
Hermes Agent 是一個(gè)由 Nous Research 開發(fā)的自進(jìn)化的 AI 代理。簡(jiǎn)單說,它就像一個(gè)能在終端里一直陪伴你的 AI 助手——可以執(zhí)行任務(wù)、寫代碼、操作瀏覽器、定時(shí)自動(dòng)化、甚至接入 Telegram/Discord 等平臺(tái)。
但問題是:Hermes 官方不支持原生 Windows。那 Windows 用戶怎么辦?
答案是:WSL2(Windows Subsystem for Linux)。通過 WSL2,你可以在 Windows 上無縫運(yùn)行 Hermes Agent,享受完整的 Linux 用戶體驗(yàn),同時(shí)還能調(diào)用 Windows 資源(Edge 瀏覽器、本地文件等)。
本文會(huì)手把手帶你完成全部部署,從零開始,包教包會(huì)。

一、前置準(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 運(yùn)行的地方
↓
Hermes Agent(CLI 交互、自動(dòng)化任務(wù)、網(wǎng)關(guān)服務(wù))Hermes 跑在 WSL2 的 Linux 里,但可以通過配置操作 Windows 里的 Edge 瀏覽器。
二、安裝 WSL2
如果你已經(jīng)裝了 WSL2,可以直接跳到第三節(jié)。
2.1 一鍵安裝
以管理員身份打開 PowerShell 或 CMD,運(yùn)行:
wsl --install
這條命令會(huì)自動(dòng):
- 啟用 WSL 功能
- 安裝默認(rèn)的 Ubuntu 發(fā)行版
- 設(shè)置 WSL2 為默認(rèn)版本
2.2 重啟電腦
安裝完成后重啟,首次啟動(dòng) Ubuntu 時(shí)會(huì)要求你設(shè)置 Linux 用戶名和密碼。
2.3 驗(yàn)證安裝
# 在 Windows 終端或 PowerShell 中 wsl -l -v # 你應(yīng)該看到類似輸出: # NAME STATE VERSION # Ubuntu Running 2
如果版本顯示為 1,可以手動(dòng)升級(jí):
wsl --set-version Ubuntu 2
2.4 (可選)更換國內(nèi)鏡像源
對(duì)于國內(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 終端中運(yùn)行:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
這個(gè)安裝腳本會(huì)幫你自動(dòng)完成:
- 安裝系統(tǒng)依賴(Python、Node.js、ripgrep、ffmpeg 等)
- 克隆 Hermes Agent 倉庫
- 創(chuàng)建 Python 虛擬環(huán)境(使用 uv 或 pip)
- 安裝所有 Python 依賴
- 創(chuàng)建全局
hermes命令 - 自動(dòng)配置 LLM 提供商
3.2 重新加載 shell
安裝完成后,重新加載配置:
source ~/.bashrc
3.3 驗(yàn)證安裝
hermes doctor
這條命令會(huì)診斷環(huán)境是否正常。如果看到綠色提示,說明安裝成功。
3.4 常見安裝問題
問題:下載太慢或超時(shí)
如果下載 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 # 然后重新運(yùn)行安裝 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 只是一個(gè)殼,真正干活需要對(duì)接一個(gè) LLM(大語言模型)。
4.1 使用hermes model命令
hermes model
這是一個(gè)交互式向?qū)В瑫?huì)引導(dǎo)你選擇提供商和模型。
4.2 推薦提供商
| 場(chǎng)景 | 推薦 | 說明 |
|---|---|---|
| 最省心 | Nous Portal | 免費(fèi)額度,直接使用 |
| 模型最多 | OpenRouter | 200+ 模型可選,按量付費(fèi) |
| 已有 OpenAI 賬號(hào) | OpenAI | 直接使用 GPT 系列 |
| 已有 Anthropic 賬號(hào) | Anthropic | 使用 Claude 系列 |
| 本地運(yùn)行 | Ollama / llama.cpp | 用本地 GPU 或 CPU 推理 |
| 國產(chǎn)模型 | DeepSeek / z.ai GLM | 國內(nèi)訪問快,延遲低 |
4.3 手動(dòng)配置(推薦國內(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 驗(yàn)證聊天
配置完成后,直接輸入 hermes 啟動(dòng)交互式 TUI:
hermes
輸入任意問題測(cè)試響應(yīng),如果能正?;卮穑f明部署成功。
五、進(jìn)階:配置 Edge 瀏覽器支持
這是很多用戶需要的功能——讓 Hermes 在 WSL 里通過 Windows Edge 瀏覽器執(zhí)行網(wǎng)頁操作(發(fā)文章、填表單、截圖等)。
5.1 為什么需要特殊配置
WSL2 和 Windows 是獨(dú)立的網(wǎng)絡(luò)命名空間。WSL 里的自動(dòng)化庫(Playwright 等)無法直接操控 Windows 上運(yùn)行的 Edge 瀏覽器進(jìn)程。解決方案是:在 Windows 端啟動(dòng)一個(gè) Playwright 服務(wù)器,WSL 通過 HTTP API 遠(yuǎn)程控制它。
5.2 在 Windows 上安裝 Node.js 和 Playwright
在 Windows 上打開 PowerShell(管理員):
# 創(chuàng)建項(xiàng)目目錄 mkdir C:\edge-automation cd C:\edge-automation # 初始化項(xiàng)目和安裝依賴 npm init -y npm install playwright # 安裝 Edge 瀏覽器支持 npx playwright install msedge
5.3 創(chuàng)建自動(dò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òng)');
}
// 導(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 }); }
});
// 點(diǎn)擊元素
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ù)器已啟動(dòng): http://0.0.0.0:${PORT}`);
});
});5.4 啟動(dòng)服務(wù)器
cd C:\edge-automation node server.js
保持這個(gè) PowerShell 窗口打開。服務(wù)器啟動(dòng)后,會(huì)彈出一個(gè) 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 中測(cè)試連接
打開另一個(gè) WSL 終端,獲取 Windows 的局域網(wǎng) IP:
# 方法1:通過 resolv.conf cat /etc/resolv.conf | grep nameserver # 方法2:通過 ipconfig ipconfig.exe | grep "IPv4"
然后測(cè)試連接(假設(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"}'
# 點(diǎn)擊搜索按鈕
curl -X POST http://192.168.1.100:8080/click \
-H "Content-Type: application/json" \
-d '{"selector":"#su"}'
六、日常使用指南
6.1 常用命令
hermes # 啟動(dòng)交互式 CLI hermes model # 切換模型/提供商 hermes setup # 運(yùn)行配置向?qū)? hermes gateway # 啟動(dòng)消息網(wǎng)關(guān)(Telegram/Discord 等) hermes update # 更新到最新版本 hermes doctor # 診斷問題 hermes config set # 修改配置項(xiàng)
6.2 配置自動(dòng)更新
# 創(chuàng)建 cron 任務(wù),每天凌晨檢查更新 hermes cron create \ --schedule "0 3 * * *" \ --cmd "hermes update" \ --name "daily-update"
6.3 保存配置到內(nèi)存
Hermes 會(huì)自動(dòng)在對(duì)話中學(xué)習(xí)你的偏好,但你也可以手動(dòng)保存重要配置:
hermes config set editor "vim" hermes config set default_model "deepseek/deepseek-chat"
6.4 使用 Skills(技能)
Skills 是 Hermes 最大的亮點(diǎn)之一——它會(huì)把做過的復(fù)雜任務(wù)保存為可復(fù)用的技能:
# 列出已有技能 hermes skills list # 使用某個(gè)技能 hermes skill run 技能名稱
七、故障排查
7.1 hermes 命令找不到
# 重新加載 shell 配置 source ~/.bashrc # 或手動(dòng)添加 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 更新失敗
# 進(jìn)入安裝目錄手動(dòng)更新 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 的全部功能。整個(gè)流程雖然步驟不少,但每一步都有明確的指令,跟著做就行。
部署完成后,你就擁有一個(gè):
- ? 可對(duì)話的 AI 助手
- ? 能執(zhí)行代碼和命令的自動(dòng)化代理
- ? 可定時(shí)執(zhí)行任務(wù)的調(diào)度器
- ? 能操控 Windows Edge 瀏覽器的遠(yuǎn)程控制能力
- ? 支持 Telegram/Discord 等多平臺(tái)的網(wǎng)關(guān)
Hermes Agent 最強(qiáng)大的地方在于它的學(xué)習(xí)能力——你用得越多,它就越懂你。每次完成任務(wù)后它會(huì)自動(dòng)生成技能,下次遇到類似任務(wù)就能直接復(fù)用。
以上就是Windows上部署Hermes Agent的完整指南的詳細(xì)內(nèi)容,更多關(guān)于Windows部署Hermes Agent的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章

Docker 部署 Hermes Agent 完整實(shí)戰(zhàn)指南(Windows / Linux 通用)
本文將詳細(xì)介紹如何通過 Docker 快速部署 Hermes Agent,部署前先為大家提供 Docker 一鍵安裝與鏡像加速方案,適配絕大多數(shù)場(chǎng)景,新手也能輕松上手,感興趣的朋友跟隨小編一2026-04-24
Windows上部署Hermes-Agent的實(shí)現(xiàn)步驟
本文詳細(xì)介紹了如何在Windows系統(tǒng)上部署和使用Hermes-Agent,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一2026-04-23
Windows本地部署Hermes Agent的完整教程:一鍵安裝腳本與避坑指南
本文將為您提供一份保姆級(jí)的 Hermes安裝 教程,無論您是 AI 開發(fā)者還是效率工具愛好者,只需通過簡(jiǎn)單的一鍵腳本,即可在 Windows 環(huán)境下快速部署 Hermes Agent,本文還總結(jié)了2026-04-14




