推荐三种Windows Server部署Hermes Agent方案：一、PowerShell一键安装（需.NET 4.8+、PS 5.1+及管理员权限）；二、WSL2子系统部署（规避Windows权限与连接干扰，适合飞书网关长连接）；三、手动构建隔离venv（解决已有Python环境冲突）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 Windows Server 环境中部署 Hermes Agent，但遇到依赖缺失、权限受限或网关启动失败等问题，则可能是由于系统组件未启用、PowerShell 执行策略限制或虚拟环境隔离导致。以下是针对 Windows Server 场景的多种部署路径：
一、使用 PowerShell 一键安装（推荐标准服务器环境）
该方法适用于已启用 .NET Framework 4.8+、PowerShell 5.1+ 且具备管理员权限的 Windows Server（如 2019/2022）。脚本将自动拉取并安装 Python、Node.js、Git、ripgrep 等运行时依赖，并创建独立 venv。
1、以管理员身份打开 PowerShell。
2、执行执行策略绕过命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force。
3、运行官方安装脚本：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
4、等待脚本完成全部依赖检测与安装，过程中不中断、不关闭窗口。
二、通过 WSL2 子系统部署（推荐高安全要求或长期运行场景）
Windows Server 默认支持 WSL2，该方式可规避 Windows 权限模型对 Python 包管理、WebSocket 连接及文件锁的干扰，特别适合飞书网关需稳定长连接的生产环境。
1、启用 WSL2 功能：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。
2、启用虚拟机平台：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。
3、重启服务器后，下载并安装 WSL2 内核更新包，再运行 wsl --update。
4、安装 Ubuntu 22.04 LTS 发行版：wsl --install -d Ubuntu-22.04。
5、进入 Ubuntu 后依次执行：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，随后运行 source ~/.zshrc && hermes --version 验证。
三、手动构建 venv 并注入关键依赖（推荐已存在冲突 Python 环境的服务器）
当服务器已部署其他 Python 服务且全局 pip 环境混乱时，此方法可完全隔离 Hermes 运行时，避免版本冲突与权限覆盖风险。
1、下载并解压 Hermes 源码 ZIP 包至 C:\hermes-src 目录。
2、以管理员身份运行 PowerShell，执行：python -m venv C:\hermes-env。
3、激活环境：C:\hermes-env\Scripts\Activate.ps1（若提示策略错误，先执行 Set-ExecutionPolicy RemoteSigned -Scope Process）。
4、在激活环境中安装核心依赖：pip install -r C:\hermes-src\requirements.txt。
5、单独安装飞书 SDK：pip install lark-oapi。
6、将 C:\hermes-src 下的 hermes 可执行脚本复制到 C:\hermes-env\Scripts\ 目录下。
