Windows安裝Hermers（WSL2版本）

WSL安裝使用Ubuntu

# 场景1：新电脑，第一次配置 WSL
wsl --install -d Ubuntu    # 安装 Ubuntu
# 重启电脑
wsl                         # 重启后，直接 wsl 就能进入

# 场景2：电脑里有 Ubuntu 和 Debian 两个系统
wsl -l -v                   # 查看：Ubuntu (默认)，Debian (未默认)
wsl                         # 进入 Ubuntu（因为是默认）
wsl -d Ubuntu              # 进入 Debian等其他系统（进入其他指定名称的系统）

# 场景3：日常使用 Hermes
wsl                         # 进入 Ubuntu
hermes chat  # 直接运行 chat 命令，进入对话界面
hermes -z "你是什么模型" chat            # 使用 -z 参数传递提示词
exit                        # 退出回到 Windows PowerShell

WSL安装致开机黑屏故障

如果wsl命令安装Ubuntu后重启电脑发现主机运行但是屏幕黑屏、鼠标键盘均无反应，说明启动被改了

故障原因

安装 WSL 自动修改 BIOS 虚拟化、系统引导配置，参数错乱引发开机黑屏无法进系统。

处理步骤

进 BIOS高级，退出一栏中选择载入最佳默认设置，保存重启，恢复硬件引导即可进入系统。
进系统→Windows 可选功能，取消勾选【适用于 Linux 的 Windows 子系统、虚拟机平台】，重启卸载旧异常配置。
再次打开功能，重新勾选两项、重启。
Microsoft 商店安装官方 Ubuntu，自动部署 WSL，安装稳妥无冲突。
两种安装区别
wsl --install命令：一键全自动，易装测试版，容易参数出错黑屏；
手动勾选系统功能 + 商店装 Ubuntu：分步安装稳定正式版，兼容性更好。

WSL UI管理工具

安裝Hermes

# 安装必要工具
sudo apt update && sudo apt install -y git curl

# 一键安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 刷新环境
source ~/.bashrc

# 配置并启动
hermes

安装Hermes超时问题

# 1. 获取 Windows 宿主机的 IP 地址（在 WSL2 中执行）
# 这个命令会返回类似 "192.168.x.x" 的地址
host_ip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')

# 2. 验证获取到的 IP 地址
echo $host_ip

# 3. 使用宿主机 IP 和正确的端口（10809）设置代理
export http_proxy="http://${host_ip}:10809"
export https_proxy="http://${host_ip}:10809"

# 4. （可选）如果代理还需要 SOCK5 支持
# export all_proxy="socks5://${host_ip}:10809"

# 5. 验证代理是否生效
curl -I https://github.com

# 6. 代理生效后，重新运行 Hermes 安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

配置Model及key

hermes model命令可以配置模型，或在～/.hermes/.env 里设置 API 密钥。

配置Channel

安装完成

测试

安装WebUI

hermes dashboard

#如果node.js版本太低会导致失败
# 添加 NodeSource 官方仓库并安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证版本
node -v   # 应该显示 v22.x.x

打开 http://127.0.0.1:9119/ 网页即可

hermes-webui安装

安装有chat对话的webui
https://github.com/nesquena/hermes-webui

hermes chat  #进入交互式终端
"查看仓库并安装运行：  https://github.com/nesquena/hermes-webui ，安装位置： /opt"

成功启动8787端口并访问

如果安装失败，可以手动下载安装

#下载压缩包然后解压到\\wsl$\Ubuntu\root\hermes-webui

# 1. 设置环境变量，指向你的 Hermes Agent Python
export HERMES_WEBUI_PYTHON="/usr/local/lib/hermes-agent/venv/bin/python"

# 2. 现在再运行 bootstrap.py
python3 bootstrap.py

# 3. 测试可以设置永久环境变量
echo 'export HERMES_WEBUI_PYTHON="/usr/local/lib/hermes-agent/venv/bin/python"' >> ~/.bashrc
source ~/.bashrc

后续启动hermes-webui

cd ~/hermes-webui && ./ctl.sh start

重新配置channel

hermes gateway setup

高级技巧：把 wsl hermes 做成 Windows 右键菜单，或者用 Windows Terminal 固定一个 Hermes 标签页，效率加倍。