需在Windows中通过WSL2运行Hermes Agent，须依次完成：一、启用并安装WSL2及Ubuntu；二、配置网络与端口转发；三、安装Rust/Node.js等依赖；四、克隆源码并启动服务；五、从Windows主机访问验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Windows系统中利用WSL2环境运行Hermes Agent以支持跨平台开发流程，则需确保Linux子系统正确配置、网络互通且依赖组件兼容。以下是实现该目标的具体操作路径：
一、启用并安装WSL2环境
WSL2提供完整的Linux内核接口与独立的虚拟化网络栈，是运行Hermes Agent的前提基础。必须确认Windows版本支持WSL2，并完成轻量级发行版部署。
1、以管理员身份打开PowerShell，执行命令：wsl --install。
2、重启计算机后，在Microsoft Store中下载并安装Ubuntu 22.04 LTS或更新版本。
3、首次启动Ubuntu，设置非root用户及密码，完成后执行：wsl -l -v验证状态为“Running”且版本显示为“2”。
二、配置WSL2网络与端口转发
Hermes Agent常需监听本地端口并与Windows主机通信，而WSL2默认使用NAT网络，需手动映射端口以保障服务可达性。
1、在Windows上以管理员身份打开PowerShell，执行：netsh interface portproxy add v4tov4 listenport=8080 listenaddress=0.0.0.0 connectport=8080 connectaddress=$(wsl hostname -I | awk '{print $1}')。
2、创建文件 %USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState\wsl.conf（若不存在则新建），写入以下内容：
[network]\ngenerateHosts = true\ngenerateResolvConf = true
3、关闭所有WSL实例：wsl --shutdown，再重新启动Ubuntu终端。
三、安装Hermes Agent运行依赖
Hermes Agent通常基于Rust或Node.js构建，需在WSL2中安装对应工具链及系统库，避免因缺失libc或openssl头文件导致编译失败。
1、更新包管理器并安装基础构建工具：sudo apt update && sudo apt install -y build-essential curl git libssl-dev pkg-config。
2、若Hermes Agent为Rust项目，执行：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh，随后运行：source $HOME/.cargo/env。
3、若为Node.js项目，使用nvm安装LTS版本：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash，然后重启shell并执行：nvm install --lts && nvm use --lts。
四、克隆并启动Hermes Agent服务
从源码构建可确保适配WSL2的Linux ABI与路径约定，同时便于调试日志输出与信号处理行为。
1、克隆官方仓库（以GitHub公开地址为例）：git clone https://github.com/hermes-org/agent.git && cd agent。
2、根据项目文档检查是否需要修改默认绑定地址，将配置中的 host 字段设为 0.0.0.0 而非 127.0.0.1。
3、执行构建与运行命令，例如：cargo run --release -- --config ./config.yaml 或 npm start。
五、从Windows主机访问Hermes Agent服务
服务启动后，Windows应用程序可通过localhost直接调用WSL2中暴露的端口，但需确认防火墙未拦截且端口处于LISTEN状态。
1、在WSL2中运行：ss -tuln | grep ':8080'，确认输出包含 0.0.0.0:8080。
2、在Windows命令提示符中执行：curl http://localhost:8080/health，预期返回HTTP 200响应体。
3、若使用浏览器访问，直接输入 http://localhost:8080/ui（依实际路由而定）即可加载前端界面。
