Hermes Agent本地运行 windows在个人电脑上部署Hermes Agent，Hermes Agent是一款自学习AI智能体系统，支持一键安装与飞书深度集成。本教程详解Windows下从零部署全流程，涵盖依赖自动安装、模型配置、飞书机器人接入及四大典型兼容性问题修复，助你快速构建企业级AI协作平台。
一、确认系统兼容性与前置条件
Windows 原生环境不被官方推荐，但可通过 PowerShell 管理员模式配合自动脚本实现部署;Linux/macOS/WSL2是更稳定的选择。部署前需确保基础工具已就位，否则后续步骤将中断。
1、打开终端(PowerShell 或 WSL2 中的 bash)，执行 git --version 验证 Git 是否可用。
2、执行 Python --version 检查 Python 是否为 3.10–3.12 版本范围。
3、执行 node --version 确认 node.js 已安装且版本不低于 18.x。
4、若任一命令报错，需先手动安装对应组件，再继续后续流程。
二、一键安装 Hermes Agent 主体环境
该步骤通过官方 install.ps1 脚本自动拉取并配置全部运行依赖，包括 Python 包、Node.js模块及系统级工具，避免手动逐项安装引发的路径或版本冲突。
1、以管理员身份启动 PowerShell。
2、执行以下命令：irm iex。
3、等待脚本输出 Installation completed successfully 提示，期间勿关闭窗口。
4、安装完成后，终端将自动进入初始配置向导。
三、完成初始配置与模型绑定
配置向导用于生成基础运行参数，其中模型供应商设置直接影响后续推理能力是否可用;跳过飞书等消息平台选项是必要操作，因需单独通过 Gateway模块接入。
1、在向导中选择 Quick setup 选项。
2、在模型供应商列表中，选择您已获取 API Key 的服务商(如 DashScope、OpenRouter 或 Kimi)。
3、当提示选择消息平台时，直接按回车跳过(飞书不在默认列表中)。
4、对后续自动化配置项统一输入 Y 确认。
5、看到欢迎界面及 Hermes is ready! 字样，表示主体配置完成。
四、修复模型未识别问题
Windows 下常见模型名称显示为空或报错“no model found”，本质是环境变量未正确注入至 Hermes内置虚拟环境中，需通过交互命令强制指定模型标识符。
1、在已启动的 Hermes 会话中，输入命令：/model。
2、根据提示输入目标模型全名，例如：dashscope/qwen-max 或openrouter/anthropic/claude-3-haiku。
3、再次执行 /model 查看当前模型状态，确认返回值中包含已输入的模型名称。
4、若仍为空，检查对应服务商的 API Key 是否已正确写入 .env 文件且无多余空格。
五、手动安装飞书网关依赖(Windows 必做)
Hermes Gateway 在 Windows 上运行时默认缺少 lark-oapi SDK，导致飞书连接初始化失败;该依赖必须安装到 Hermes自带的 venv 中，而非全局 Python 环境。
1、新开一个 PowerShell 窗口，切换至 Hermes 安装目录(通常为C:\Users\{用户名}\AppData\Local\hermes-agent\venv)。
2、执行：.\Scripts\pip.exe install lark-oapi。
3、验证安装结果：运行 .\Scripts\python.exe -c "import lark_oapi; print('OK')"，输出 OK即成功。
4、返回原 Hermes 终端，重新执行 hermes gateway setup 启动配置流程。
End
