Windows本地部署Core教程，30分钟跑通HermesAgent

想在Windows电脑上本地运行功能强大的Hermes Agent却苦于官方无原生支持？别担心，本文为你揭秘两种实测30分钟内即可跑通的可靠部署方案：无需WSL2的PowerShell一键安装（适合快速体验基础对话），以及更稳定、功能更完整的WSL2原生部署（支持网关、本地模型加载和系统服务管理等全部特性），无论你是新手尝鲜还是长期深度使用，都能找到最适合自己的路径，即刻开启本地AI智能体之旅。

如果您希望在Windows系统上本地运行Hermes Agent，但发现官方不提供原生支持，则必须借助兼容Linux环境的运行层。以下是两种经实测可在30分钟内完成部署的可靠方法：

一、PowerShell一键部署（适合快速体验）

该方式无需安装WSL2或任何Linux子系统，直接通过Windows原生命令行调用官方PowerShell安装脚本，自动检测并安装Python、Node.js、Git、ripgrep等全部依赖，全程图形界面无感知，适用于仅需基础对话功能的用户。

1、按Win + X键，选择“终端（管理员）”或“Windows PowerShell（管理员）”。

2、粘贴并执行以下命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。

3、等待脚本自动下载、解压、配置环境，进度条走完后将自动进入hermes setup向导。

4、在向导中输入1选择Quick setup，再根据提示输入模型供应商编号（如Z.AI为15、Kimi为8）、粘贴API Key（输入时不可见属正常）、填写Base URL及模型名称。

5、当看到绿色文字显示Hermes Agent is ready! You can now run 'hermes' to start chatting.即表示部署成功。

二、WSL2原生部署（推荐长期使用）

该方式在Windows中构建完整Ubuntu Linux运行环境，可启用Hermes Agent全部功能（包括Gateway网关、本地模型加载、systemd服务管理等），规避PowerShell下缺失lark-oapi、ffmpeg路径异常、uv虚拟环境隔离失败等已知缺陷，是官方唯一明确支持的Windows部署路径。

1、以管理员身份打开PowerShell，依次执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 和 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart。

2、重启电脑。

3、重启后再次打开PowerShell（普通用户权限），执行：wsl --set-default-version 2。

4、执行：wsl --install -d Ubuntu-22.04，等待自动下载安装完成。

5、启动Ubuntu应用，设置Linux用户名（英文小写，无空格）和密码（务必牢记）。

6、在Ubuntu终端中执行国内镜像加速命令：sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list && sudo apt update && sudo apt upgrade -y。

7、运行Hermes安装脚本：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash。

8、执行source ~/.bashrc刷新环境变量，随后验证：hermes version与hermes doctor均返回✅结果即为成功。

今天带大家了解了的相关知识，希望对你有所帮助；关于科技周边的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~