背景

Hermes Agent 是 Nous Research 開發(fā)的 AI 智能體，可以在 WSL2 中運行并提供 Web Dashboard 界面。但每次啟動都需要打開 WSL2 終端，運行命令，然后手動打開瀏覽器訪問 http://127.0.0.1:9119，步驟繁瑣。

需求

我們希望在 Windows 桌面上雙擊一個圖標，就能自動完成：

1. 檢查 Dashboard 是否已在運行
2. 如果已在運行 → 直接打開瀏覽器
3. 如果沒運行 → 自動在后臺啟動，等就緒后再打開瀏覽器

解決方案：.bat 啟動腳本

創(chuàng)建一個 .bat 批處理文件，利用 Windows 的 wsl 命令啟動 WSL2 中的 Hermes，并用 curl 檢測端口狀態(tài)。

實現(xiàn)要點

.bat 腳本編寫踩坑記錄

這部分是本文的核心價值，記錄了編寫這個不到30行 .bat 文件時踩的所有坑。

坑1：%errorlevel%在代碼塊里不實時更新

.bat 文件中，%errorlevel% 在 (...) 代碼塊里只會在進入代碼塊時解析一次，后續(xù)變化不會反映到 %errorlevel% 里。

if condition (
    some_command          :: 這個命令改變了 errorlevel
    echo %errorlevel%    :: ? 這里永遠是進入代碼塊時的值，不是最新值！
)

解決方法：用 setlocal enabledelayedexpansion 開啟延遲環(huán)境變量擴展，然后用 !errorlevel! 獲取實時值。

坑2：!errorlevel!必須開啟延遲擴展才能用

如果直接用 !errorlevel! 而沒有在文件開頭加 setlocal enabledelayedexpansion，cmd.exe 會報錯。

:: ? 錯誤寫法（會報錯）
@echo off
echo !errorlevel!
:: ? 正確寫法
@echo off
setlocal enabledelayedexpansion
echo !errorlevel!

坑3：if %errorlevel%==0在代碼塊里失效

同理，因為 %errorlevel% 只解析一次，判斷結(jié)果不準確。

解決方法：用 if not errorlevel 1（經(jīng)典寫法，不需要延遲擴展）。

if not errorlevel 1 的含義是：如果 errorlevel 不小于 1（即 errorlevel == 0）

這是 Windows .bat 腳本的經(jīng)典 idiom，推薦優(yōu)先使用。

坑4：%%在 .bat 文件中的特殊含義

在 .bat 文件中，%% 表示一個 literal % 字符。所以當我們要將 %{http_code} 傳遞給 curl 的 -w 參數(shù)時，必須寫成 %%{http_code}。

:: 在 .bat 文件里這樣寫：
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/

:: cmd.exe 執(zhí)行時，%%{http_code} → %{http_code}
:: 這正是 curl -w 參數(shù)期望的格式化字符串

如果在 .bat 文件里直接寫 %{http_code}，cmd.exe 會試圖將 {http_code} 當作環(huán)境變量來展開，導(dǎo)致錯誤。

坑5：start /min wsl ...的進程生命周期

最開始我用了 wsl -d Ubuntu-22 -- ... 直接啟動，但發(fā)現(xiàn) .bat 文件執(zhí)行完畢后，WSL 進程也隨之退出（因為 .bat 是同步等待子進程結(jié)束的）。

解決方法：用 start /min wsl ... 在獨立的最小化窗口中啟動 WSL，這樣：

• .bat 文件不會被阻塞（ start 是異步的）
• WSL 進程不會隨 .bat 退出而丟失
• 窗口是最小化的，不會干擾用戶

坑6：timeout /t在等待循環(huán)里不能用/nobreak

timeout /t 1 /nobreak 在某些 Windows 版本里會等待用戶按鍵。在等待循環(huán)里應(yīng)該用 timeout /t 1 >nul 靜默等待。

完整代碼

將以下內(nèi)容保存為 Hermes Web.bat，放到桌面：

@echo off
chcp 65001 >nul 2>&1
setlocal EnableDelayedExpansion
title Hermes Web Dashboard

echo ============================================
echo    Hermes Agent - Web Dashboard Launcher
echo ============================================
echo.

:: Check if already running
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/ 2>nul | findstr "200" >nul
if not errorlevel 1 (
    echo [OK] Already running, opening browser...
    start http://127.0.0.1:9119
    exit /b 0
)

echo [INFO] Starting Hermes Dashboard in WSL2...
start /min wsl -d Ubuntu-22 --user sanlin -- bash -c "cd ~/.hermes/hermes-agent && source .venv/bin/activate && hermes dashboard --host 0.0.0.0 --insecure --tui --no-open"

echo [INFO] Waiting for dashboard to start...
timeout /t 5 >nul

:waitloop
curl -s -o nul -w "%%{http_code}" http://127.0.0.1:9119/ 2>nul | findstr "200" >nul
if not errorlevel 1 (
    echo [OK] Dashboard is ready!
    start http://127.0.0.1:9119
    exit /b 0
)
timeout /t 1 >nul
goto waitloop

代碼說明：

• chcp 65001：切換到 UTF-8 代碼頁，支持中文顯示
• setlocal EnableDelayedExpansion：開啟延遲環(huán)境變量擴展（本腳本里用 if not errorlevel 1 代替了 !errorlevel!，所以其實可以不用，但加上是好習(xí)慣）
• start /min wsl ...：在最小化窗口啟動 WSL2，不阻塞 .bat 執(zhí)行
• :waitloop 循環(huán)：每秒檢測一次端口，最多等 30 秒（代碼里是無限循環(huán)，可以自行加上計數(shù)器限制）

使用方法

1. 打開記事本（Notepad）
2. 粘貼上面的代碼
3. 另存為 → 選擇桌面 → 文件名填 Hermes Web.bat → 編碼選 ANSI 或 UTF-8 均可 → 保存
4. 雙擊桌面上的 Hermes Web.bat 圖標

效果

總結(jié)

通過 .bat 腳本 + wsl 命令，可以在 Windows 上優(yōu)雅地啟動 WSL2 中的 Hermes Agent，并自動打開瀏覽器訪問 Web Dashboard。

核心知識點：

1. .bat 腳本中 %errorlevel% 在代碼塊里不實時更新 → 用 if not errorlevel 1 或 !errorlevel!
2. %% 在 .bat 中表示 literal % → 寫 %%{http_code} 才能讓 curl 收到 %{http_code}
3. start /min 可以讓子進程在獨立窗口運行，不隨父進程退出而丟失

到此這篇關(guān)于在Windows上優(yōu)雅地啟動Hermes Agent Web Dashboard的詳細步驟的文章就介紹到這了,更多相關(guān)Windows啟動Hermes Agent Web Dashboard內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論