HermesAgent本地部署零基础保姆级教程_Windows系统一键安装指南
零基础Windows用户部署Hermes Agent：从WSL2到智能对话的完整指南
对于希望在Windows系统上体验Hermes Agent强大功能的用户来说，最大的障碍往往不是工具本身，而是第一步——本地部署。环境配置复杂、依赖缺失、脚本执行失败……这些问题听起来是不是很熟悉？别担心，其实绝大多数问题都源于两个关键环节：要么是Windows子系统（WSL2）没有正确启用，要么是安装程序没有获得足够的管理员权限。
下面这份一站式操作指南，将帮你轻松跨越从0到1的门槛。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、启用 WSL2 子系统并安装 Ubuntu
首先要明确一个前提：Hermes Agent无法直接在Windows原生环境中运行。它需要一个兼容的Linux环境，而WSL2正是微软官方提供的完美解决方案。这一步是所有后续操作的基础，如果缺失，安装脚本将完全无法执行。
具体操作可以分解为几个清晰的步骤：
1、首先，请务必以管理员身份打开PowerShell窗口。
2、依次执行以下两条核心命令：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3、完成上述命令后，重启电脑。重启后，在普通的PowerShell中运行这条命令来设置默认版本：wsl --set-default-version 2。
4、最后，打开Microsoft Store，搜索并安装Ubuntu 22.04 LTS。首次启动时，系统会提示你设置用户名和密码。记住，用户名建议使用全小写字母，输入密码时屏幕不显示是正常现象。
二、执行一键安装脚本
环境准备好了，接下来就是安装主体。官方提供的一键安装脚本非常智能，它会自动检测并部署所有必要组件，包括Python 3.11、Node.js v22、Git、ripgrep等，整个过程基本无需手动干预，对绝大多数网络环境都适用。
1、打开刚才安装好的Ubuntu终端，根据你的网络环境选择对应的命令：
如果你是国际网络用户，执行：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
如果你是国内用户，为了获得更稳定的下载速度，请执行：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
2、耐心等待脚本运行。当你看到终端输出[OK]的提示，并且没有出现红色的Error错误信息时，就代表安装成功了。
3、安装成功后，有一个非常关键且容易被忽略的步骤：立即执行source ~/.bashrc来刷新环境变量。如果不执行这一步，系统将无法识别后续的hermes命令。
三、PowerShell 原生安装（备选方案）
当然，并非所有情况都适合使用WSL2。如果你的电脑受企业策略限制、磁盘空间不足，或者虚拟化功能被禁用，那么还有一条“备选路线”可以走——官方提供的Windows原生命令行安装方式。这种方式直接绕过Linux子系统，在PowerShell中完成所有部署。
1、同样，需要以管理员身份打开PowerShell。
2、执行以下命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
3、等待安装完成，当出现Installation completed successfully的提示时，说明Python、Node.js、Git等组件已自动安装完毕，并且全局的hermes命令也已注册成功。
4、关闭当前的PowerShell窗口，然后重新打开一个新的。输入hermes --version来验证命令是否已经可用。
四、配置模型服务接入
到这里，Hermes Agent的“身体”已经安装好了，但它还没有“大脑”。Hermes Agent本身并不内置大模型，必须通过外部API接入才能进行智能对话。因此，这一步配置至关重要，如果出错，将直接导致对话没有响应或服务启动失败。
1、在终端中（Ubuntu或PowerShell均可，取决于你的安装方式）输入：hermes setup，这会启动一个交互式的配置向导。
2、在提供的基础模型选项中，使用方向键选择Custom endpoint (OpenAI compatible)，即自定义的兼容OpenAI的接口。
3、在Base URL一栏中，粘贴以下地址：https://api.yibuapi.com/v1（这是一步API的推荐地址，稳定性和兼容性都经过验证）。
4、最后，粘贴你从yibuapi.com控制台获取的以“sk-”开头的API Key。系统会自动将这些配置信息保存到config.yaml文件中。
五、验证运行状态
配置好模型服务后，Hermes会在你的用户目录下（通常是~/.hermes/）初始化本地数据目录，里面包含SQLite数据库、技能文件夹和记忆文件夹等。最后这个步骤，就是进行一次全面的“体检”，确保所有功能都准备就绪。
1、执行命令：hermes doctor。这个命令会对你的整个部署环境进行一项一项的检测。
2、如果所有检查项前面都显示为绿色的[✓]或状态为OK，那么恭喜你，配置完全正确。
3、输入命令：hermes chat，正式进入交互式聊天界面。试着发送一条任意消息，比如“你好”，看看是否能收到智能回复。
4、想要结束会话时，输入/exit命令即可退出。
至此，你已经成功在Windows系统上完成了Hermes Agent的本地部署，并接入了AI大脑。接下来，就可以尽情探索它的智能聊天、问答助手和AI搜索等多模态能力了。