体验WIN10安装WSL，安装Hermes Agent和 Hermes Web Ui

老钟 • 2026 年 05 月 24 日下午 10:53 • 计算机软件应用

如果是win10或者win11, 可以安装Windows Subsystem for Linux（简称WSL）, Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）.

首先，先安装wsl，参考https://learn.microsoft.com/zh-cn/windows/wsl/install

安装命令wsl --install，国内用户建议使用这个命令安装wsl --install --web-download

WSL

完成安装之后，在wsl里面使用命令安装Hermes Agent 和UI，点击下面的链接

Hermes和UI的Github地址：

https://github.com/NousResearch/hermes-agent

https://github.com/EKKOLearnAI/hermes-web-ui

Hermes agent安装

Install ripgrep for faster file search ffmpeg for TTS voice messages? [Y/n] y

下载期间出现网络方面的问题：

WSL安装Hermes Agent

Cloning into '/home/paul/.hermes/hermes-agent'...
fatal: unable to access 'https://github.com/NousResearch/hermes-agent.git/': GnuTLS recv error (-110): The TLS connection was non-properly terminated.
✗ Failed to clone repository

解决办法：

# 禁用 HTTP/2
git config --global http.version HTTP/1.1

# 同时增加缓冲区大小
git config --global http.postBuffer 1048576000

# 再次尝试安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

继续安装

Install build tools? [Y/n] y

Hermes agent安装

Hermes agent安装2

Enable sudo support? (stores password for apt install, etc.) [y/N]:y

Hermes agent安装3

选择Skip

Hermes agent安装完成

再输入一下命令，重启shell和启动Hermes

source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!

Hermes agent安装完成本地启动

由于UI默认在node.js 2.3+下运行，以下操作是卸载掉2.2版本，重新安装2.3版本 (这一步可以忽略，直接跳过也能正常安装)

# 1. 卸载系统 apt 安装的 Node.js
sudo apt remove --purge nodejs npm
sudo apt autoremove

# 2. 删除残留目录
sudo rm -rf /usr/local/lib/nodejs
sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/include/node

# 3. 清理 nvm（如果你想重新配置 nvm）
rm -rf ~/.nvm
rm -rf ~/.npm
rm -rf ~/.node-gyp

# 4. 清理 .bashrc 中的 nvm 相关行（如果有）
# 用 nano 编辑 ~/.bashrc，删除类似下面的内容：
# export NVM_DIR="$HOME/.nvm"
# [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

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

# 安装 Node.js 23
nvm install 23

# 设为默认版本
nvm alias default 23

# 验证
node -v # 应显示 v23.x.x

接下来，安装在线UI，

Linux, macOS, WSL2, Termux

bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)

Hermes agent UI安装

完成后通过 hermes-web-ui start启动，浏览器打开 http://localhost:8648/

安装Hermes-web-ui遇到的一些问题和解决办法：

安装完成之后，启动UI提醒 hermes-web-ui: command not found

解决办法：将 npm 全局 bin 目录写入 ~/.bashrc：

echo 'export PATH="$PATH:'$(npm config get prefix)'/bin"' >> ~/.bashrc
source ~/.bashrc

其他方面的设置：

本教程在win10专业版上面安装成功，win11专业版有朋友也安装成功；

在win11家庭版上面安装测试，需要设置一下才能安装wsl，若你的电脑是win11家庭版，可以参考一下下面的一些设置：

首先要确定电脑已经开启了虚拟化（任务管理器，性能，CPU查看右下角虚拟化是否启用），确定开启之后，在powershell管理员模式下面，输入以下命令：

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 启用 Hyper-V（部分系统需要）
dism.exe /online /enable-feature /featurename:Hyper-V /all /norestart

然后重启电脑，然后查询你的Hyper-V