1. 为什么选择WSL2安装Hermes Agent在Windows系统上运行Hermes Agent有两种主要方式原生Windows安装和WSL2安装。WSL2Windows Subsystem for Linux 2是微软提供的完整Linux内核兼容层相比原生Windows安装有以下优势终端兼容性WSL2提供完整的POSIX兼容终端环境支持内嵌终端面板和PTY伪终端功能开发一致性与Linux开发工具链无缝集成避免Windows与Linux的文件系统、路径处理差异性能优势在Linux文件系统上执行Git操作、文件搜索等任务比通过/mnt/c访问Windows文件快10-100倍提示如果你主要使用交互式聊天、网关功能且不涉及复杂Linux工具链原生Windows安装可能更简单2. WSL2环境准备2.1 基础安装步骤以管理员身份打开PowerShell执行安装命令wsl --install这个命令会自动完成以下操作启用WSL2功能组件安装虚拟机平台下载默认的Ubuntu发行版重启计算机后首次打开Ubuntu会提示创建Linux用户名和密码与Windows账户独立验证WSL版本wsl --list --verbose确保显示VERSION 2如果显示1则需要转换wsl --set-version Ubuntu 2 wsl --set-default-version 22.2 推荐配置优化在WSL内执行以下命令启用systemd支持sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue [interop] enabledtrue appendWindowsPathtrue [automount] options metadata,umask22,fmask11 EOF然后关闭并重启WSLwsl --shutdown重新打开终端后验证ps -p 1 -o comm应输出systemd3. Hermes Agent安装流程3.1 一键安装脚本在WSL终端中执行curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc hermes安装过程会自动下载最新版Hermes Agent设置环境变量创建~/.hermes配置目录3.2 文件系统最佳实践WSL2与Windows存在两套独立的文件系统位置WSL访问路径Windows访问路径Windows磁盘/mnt/c/Users/...C:\Users\...WSL磁盘~/code/...\\wsl$\Ubuntu\home\...强烈建议将Hermes相关文件全部放在WSL文件系统内如~/code避免在/mnt/c下进行开发操作性能差、权限问题4. 网络配置要点4.1 本地服务互通场景1WSL中的Hermes访问Windows本地服务如OllamaWindows 11 22H2用户创建或编辑%USERPROFILE%\.wslconfig[network] networkingModemirrored重启WSLwsl --shutdown旧版Windows需要确保服务绑定到0.0.0.0而不仅是127.0.0.1添加Windows防火墙规则4.2 外部访问WSL服务场景2从Windows访问WSL中的Hermes服务镜像模式下自动可用。传统NAT模式需要在WSL中绑定到0.0.0.0获取WSL IPip -4 addr show eth0 | grep inet从Windows直接访问该IP5. 长期运行方案5.1 使用systemd管理如果已启用systemd可以设置开机自启hermes gateway setup按提示选择安装systemd用户单元5.2 Windows自动启动创建计划任务触发器用户登录时操作启动程序C:\Windows\System32\wsl.exe参数-d Ubuntu --exec /bin/sh -c sleep infinity6. 常见问题解决问题1git status极慢原因在/mnt/c下操作解决将仓库移到WSL文件系统如~/code问题2脚本报错bad interpreter: /bin/bash^M原因Windows行尾符解决sudo apt install dos2unix dos2unix script.sh git config --global core.autocrlf input问题3休眠后时间不同步解决sudo hwclock -s7. GPU加速配置对于NVIDIA显卡确保Windows已安装最新驱动WSL内执行nvidia-smi验证识别CUDA工具链会自动使用GPU注意AMD和Intel显卡在WSL中的支持有限建议使用原生Windows版模型服务器并通过网络访问