1. 为什么选择 Hermes AgentHermes Agent 是一个功能强大的 AI 助手工具它可以帮助你完成各种日常任务从代码编写到文档处理从数据分析到自动化流程。对于 Windows 用户来说安装 Hermes Agent 有两种主要方式原生 Windows 安装和 WSL2 安装。WSL2Windows Subsystem for Linux 2是微软提供的完整 Linux 内核兼容层它比 WSL1 提供了更完整的系统调用兼容性。选择 WSL2 安装 Hermes Agent 的主要原因包括完整的 POSIX 兼容性WSL2 提供了真正的 Linux 内核支持 fork、/tmp、UNIX socket 等特性更好的终端支持WSL2 支持 PTY伪终端这对于 Hermes Agent 的 dashboard 内嵌终端功能至关重要一致的开发环境如果你已经在使用 WSL2 进行开发工作保持所有工具在同一个环境中运行会更方便2. 准备工作安装 WSL22.1 检查系统要求在开始安装前请确保你的 Windows 系统满足以下要求Windows 10 版本 2004 及更高版本推荐 Windows 1164 位系统至少 4GB 内存8GB 以上更佳已启用虚拟化功能可在 BIOS/UEFI 中检查2.2 安装 WSL2以管理员身份打开 PowerShell右键点击开始菜单选择Windows PowerShell管理员运行以下命令安装 WSL2wsl --install这个命令会自动完成以下操作启用 WSL 功能启用虚拟机平台功能下载并安装最新的 WSL2 内核设置 WSL2 为默认版本安装默认的 Ubuntu 发行版安装完成后重启计算机2.3 验证 WSL2 安装重启后打开 PowerShell 运行以下命令验证安装wsl --list --verbose你应该看到类似如下的输出NAME STATE VERSION * Ubuntu Running 2如果 VERSION 显示为 1可以运行以下命令转换为 WSL2wsl --set-version Ubuntu 2 wsl --set-default-version 23. 配置 WSL2 环境3.1 首次启动 Ubuntu在开始菜单中找到并打开Ubuntu应用首次启动会要求你创建 Linux 用户名和密码这个用户名和密码与你的 Windows 账户无关密码输入时不会显示字符这是正常现象3.2 启用 systemd推荐Hermes Agent 的一些功能如 gateway在 systemd 下运行更稳定。启用 systemd 的步骤如下在 WSL2 终端中运行sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue [interop] enabledtrue appendWindowsPathtrue [automount] options metadata,umask22,fmask11 EOF关闭所有 WSL2 终端窗口在 PowerShell 中运行wsl --shutdown重新打开 WSL2 终端运行以下命令验证 systemd 是否已启用ps -p 1 -o comm应该输出systemd4. 安装 Hermes Agent4.1 运行安装脚本在 WSL2 终端中执行以下命令curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash这个安装脚本会自动完成以下操作下载最新版 Hermes Agent安装必要的依赖项设置环境变量创建必要的目录结构4.2 更新 shell 配置安装完成后运行以下命令使更改生效source ~/.bashrc4.3 验证安装运行以下命令检查 Hermes Agent 是否安装成功hermes --version如果看到版本号输出说明安装成功。5. 文件系统管理5.1 理解 WSL2 文件系统结构WSL2 有两套文件系统Windows 文件系统在 WSL2 中通过/mnt/c/、/mnt/d/等路径访问Linux 文件系统位于~用户主目录下最佳实践是将所有 Linux 相关文件包括 Hermes Agent放在 Linux 文件系统中因为I/O 性能更好比通过/mnt/c/访问快 10-100 倍文件权限处理更可靠文件监听更稳定避免大小写敏感问题5.2 在 Windows 和 WSL2 之间传输文件从 Windows 复制文件到 WSL2在 Windows 资源管理器地址栏输入\\wsl.localhost\Ubuntu导航到目标目录如/home/用户名/直接拖放文件从 WSL2 复制文件到 Windowscp ~/文件路径 /mnt/c/Users/Windows用户名/目标路径5.3 处理行尾符问题Windows 和 Linux 使用不同的行尾符CRLF vs LF可能导致脚本无法执行。解决方法在 WSL2 中配置 gitgit config --global core.autocrlf input git config --global core.eol lf对于已有文件可以使用 dos2unix 工具转换sudo apt install dos2unix dos2unix 文件名6. 网络配置6.1 WSL2 和 Windows 的网络关系WSL2 使用虚拟网络与 Windows 主机有不同的 IP 地址。这意味着WSL2 中的 localhost 与 Windows 的 localhost 不同需要特殊配置才能使两者互通6.2 从 WSL2 访问 Windows 服务如果你在 Windows 上运行本地模型服务如 Ollama、LM Studio需要在 WSL2 中访问它们对于 Windows 11 22H2创建或编辑%USERPROFILE%\.wslconfig文件添加[wsl2] networkingModemirrored重启 WSL2wsl --shutdown对于 Windows 10 或旧版 Windows 11确保 Windows 服务绑定到0.0.0.0而不是127.0.0.1可能需要添加 Windows 防火墙规则6.3 从 Windows 访问 WSL2 中的服务要使 Windows 能访问 WSL2 中运行的 Hermes Agent 服务在 WSL2 中确保服务绑定到0.0.0.0而不是127.0.0.1对于 Windows 11 22H2 镜像模式可以直接通过localhost访问对于其他情况可能需要设置端口转发7. 长期运行 Hermes Agent 服务7.1 使用 systemd 管理服务如果你按照前面的步骤启用了 systemd可以使用以下命令设置 Hermes Agent 服务hermes gateway setup按照提示操作systemd 会自动管理服务启动和停止。7.2 保持 WSL2 运行默认情况下当没有活动终端时WSL2 会自动关闭。要让 Hermes Agent 持续运行打开 Windows 任务计划程序创建基本任务触发器用户登录时操作启动程序程序C:\Windows\System32\wsl.exe参数-d Ubuntu --exec /bin/sh -c sleep infinity这样 WSL2 会在登录时自动启动并保持运行。8. 常见问题解决8.1 连接 Windows 服务时报Connection refused可能原因服务没有绑定到0.0.0.0防火墙阻止了连接解决方案确保服务配置为监听0.0.0.0检查 Windows 防火墙设置对于 Ollama可以设置环境变量export OLLAMA_HOST0.0.0.08.2 文件操作极慢可能原因你在/mnt/c/下操作文件解决方案将工作目录移到 Linux 文件系统中如~/code/8.3 脚本报错bad interpreter: /bin/bash^M可能原因文件有 Windows 行尾符CRLF解决方案sudo apt install dos2unix dos2unix 脚本文件名8.4 休眠后时钟不同步解决方案sudo hwclock -s或安装 ntpdatesudo apt install ntpdate sudo ntpdate pool.ntp.org9. 进阶配置9.1 GPU 支持如果你的系统有 NVIDIA GPU确保在 Windows 上安装了最新的 NVIDIA 驱动在 WSL2 中运行nvidia-smi应该能看到 GPU 信息安装 CUDA 工具链如果需要sudo apt install nvidia-cuda-toolkit9.2 磁盘空间管理WSL2 使用的虚拟磁盘不会自动收缩。要回收空间关闭 WSL2wsl --shutdown在 PowerShell 中优化磁盘Optimize-VHD -Path C:\Users\你的用户名\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\LocalState\ext4.vhdx -Mode Full9.3 自定义 WSL2 内存限制默认情况下WSL2 会使用最多 50% 的物理内存。要调整限制创建或编辑%USERPROFILE%\.wslconfig文件添加内容[wsl2] memory4GB重启 WSL2wsl --shutdown10. 开始使用 Hermes Agent安装配置完成后你可以通过以下命令启动 Hermes Agenthermes常用命令hermes chat启动聊天界面hermes gateway管理网关服务hermes --help查看所有命令首次使用时建议运行设置向导hermes setup按照提示完成基本配置你就可以开始使用 Hermes Agent 的强大功能了。