必须先搭好WSL2环境，因Hermes Agent官方明确不支持原生Windows，所有依赖、路径、权限模型均基于Linux设计；启用WSL2需以管理员身份执行两条dism命令并重启电脑，随后安装Ubuntu-22.04至非C盘，再配置Maven环境变量并验证mvn -v与hermes doctor通过。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Windows上跑起Hermes Agent并让Maven命令全局可用，必须先搭好WSL2环境——它不是可选项，而是硬性前提，因为Hermes Agent官方明确不支持原生Windows，所有依赖、路径、权限模型都基于Linux设计。
启用WSL2核心功能
以管理员身份打开PowerShell，逐行执行以下两条命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
【必须重启电脑】这两条命令只是注册功能，不重启系统不会加载虚拟化驱动，后续所有步骤都会卡在“wsl: command not found”或“WslRegisterDistribution failed”错误上。
安装并迁移Ubuntu到非C盘
重启后，不要直接运行wsl --install——它默认把整个Linux文件系统塞进C盘，而Hermes Agent拉模型动辄20GB+，极易触发磁盘告警甚至系统卡死。
推荐做法：用wsl --install -d Ubuntu-22.04 --web-download命令启动安装，同时提前在D盘建好目录：mkdir D:\WSL；安装完成后，立即导出并重导入到D盘：
wsl --export Ubuntu-22.04 D:\WSL\ubuntu.tar → wsl --unregister Ubuntu-22.04 → wsl --import Ubuntu-22.04 D:\WSL\ubuntu D:\WSL\ubuntu.tar --version 2
这一步做完，wsl -l -v应显示VERSION为2且STATE为Stopped，说明已成功绑定到D盘路径。
配置Maven环境变量（WSL2内）
进入Ubuntu终端（开始菜单→Ubuntu），先下载Apache Maven二进制包：
curl -OL https://dlcdn.apache.org/maven/maven-3/3.9.7/binaries/apache-maven-3.9.7-bin.tar.gz
解压到/opt并设为只读：
sudo tar -xzf apache-maven-3.9.7-bin.tar.gz -C /opt → sudo chown -R root:root /opt/apache-maven-3.9.7 → sudo chmod -R go-w /opt/apache-maven-3.9.7
编辑~/.bashrc，在末尾追加：
export MAVEN_HOME=/opt/apache-maven-3.9.7
export PATH=$MAVEN_HOME/bin:$PATH
执行source ~/.bashrc生效，再运行mvn -v验证输出包含版本号和Java路径——若报“command not found”，说明PATH拼写错误或未执行source。
安装Hermes Agent并校验Maven可用性
方法一：国内镜像源安装（推荐）
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent → curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
方法二：直连GitHub（需稳定代理）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完毕后，运行hermes doctor。如果输出中出现maven: not found，说明前面的环境变量没生效——此时不要重复编辑.bashrc，直接在当前终端执行export PATH=/opt/apache-maven-3.9.7/bin:$PATH临时修复，再跑一次hermes doctor即可通过。
