Windows 下部署与配置 Hermes Agent 完全指南：AI 智能体、OpenRouter、LLM、本地大模型、WSL2、自动化、自进化 AI、Ollama、Claude 3.5、GPT-4
本文内容深度融合相关以下技术相关词的汇，放在文章开头以便于您快速阅读以及学习：
- 平台：Windows、WSL2
- 核心项目：Hermes Agent
- AI 能力：AI 智能体（AI Agent）、自进化 AI、自动化任务、代码解释器、浏览器控制
- 模型生态：LLM（大语言模型）、OpenRouter、Ollama、Claude 3.5 Sonnet、GPT-4o、Llama 3.1
- 部署场景：本地大模型、私有化部署、低成本 API、开发者工具
- 技术栈：YAML 配置、环境变量安全、MCP 协议、技能自动生成
为什么你需要在 Windows 上运行 Hermes Agent？
Hermes Agent 是当前最前沿的开源 AI 智能体框架之一，其最大亮点是具备“自我进化”能力——它不仅能完成你交代的任务，还能在执行过程中自动生成新技能并写入 MEMORY.md，实现持续学习。无论你是开发者、数据分析师、内容创作者还是普通用户，Hermes 都能成为你的超级生产力助手。
而Windows 作为全球最主流的桌面操作系统，支持 Hermes Agent 的完整部署，意味着数亿用户无需切换系统即可体验下一代 AI 工作流。
一、部署方式全景对比：原生 PowerShell vs WSL2
| 维度 | 原生 PowerShell 部署 | WSL2（Ubuntu）部署 |
|---|---|---|
| 适用人群 | 新手、快速体验者、非开发者 | 开发者、长期使用者、追求稳定性 |
| 安装速度 | ⚡ 极快（一键脚本） | 中等（需先配置 WSL2） |
| 兼容性 | 良好（90%+ 功能正常） | ✅ 极佳（近乎原生 Linux） |
| 本地模型支持 | 支持 Ollama / LM Studio | 完整支持 Ollama + Docker |
| 浏览器自动化 | 直接调用 Windows Chrome/Edge | 需指定/mnt/c/路径 |
| 文件系统访问 | 原生 Windows 路径 | 通过/mnt/c/访问 Windows 文件 |
| 社区推荐度 | ⭐⭐⭐☆ | ⭐⭐⭐⭐⭐ |
💡决策建议：
- 想5 分钟内跑起来？选原生 PowerShell。
- 想长期使用、集成 GitHub/MCP、跑复杂任务？选WSL2。
二、方法一：原生 Windows 部署（PowerShell 一键安装）
步骤 1：准备环境（管理员权限）
- 按
Win + X→ 选择“终端(管理员)”。 - 执行策略设置（允许脚本运行）：
Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser
步骤 2：执行官方安装脚本
irmhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex📌 脚本会自动：
- 安装 Python 3.10+、Git、Node.js、ripgrep
- 克隆仓库到
%LOCALAPPDATA%\hermes\hermes-agent- 创建 Python 虚拟环境
- 将
hermes.exe加入 PATH
步骤 3：配置模型（以 OpenRouter 为例）
安装完成后自动进入hermes setup向导：
- 选择Quick setup
- 选择OpenRouter
- 粘贴 API Key（无回显，正常！）
- 获取地址：https://openrouter.ai/settings/keys
- 推荐模型：
anthropic/claude-3.5-sonnet（强推理）或openai/gpt-4o（全能）
步骤 4：验证 & 启动
hermes--version# 查看版本hermes# 进入交互式 CLI三、方法二：WSL2 部署（开发者首选）
步骤 1：启用 WSL2（仅需一次）
# 启用组件dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart# 重启电脑后，设置默认版本wsl--set-default-version 2步骤 2：安装 Ubuntu 22.04
- 打开Microsoft Store→ 搜索“Ubuntu 22.04 LTS”→ 安装
- 首次启动时设置Linux 用户名/密码
步骤 3：在 Ubuntu 中安装 Hermes
sudoaptupdate&&sudoaptinstall-ypython3-pipgitcurlcurl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bashsource~/.bashrc hermes setup🔧浏览器自动化配置（WSL2 专用）
编辑~/.hermes/config.yaml，添加：tools:browser:executable_path:"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
四、核心配置详解（config.yaml）
1. 模型配置（支持多平台）
model:# 方案A：OpenRouter（聚合百种模型）provider:custombase_url:"https://openrouter.ai/api/v1"api_key_env:"OPENROUTER_API_KEY"model_name:"anthropic/claude-3.5-sonnet"# 方案B：Ollama（本地运行 Llama 3.1 / Mistral 等）# provider: ollama# model_name: "llama3.1:8b"# base_url: "http://localhost:11434"2. 工具启用（按需开启）
tools:code_interpreter:{enabled:true,timeout:120}# Python 执行browser:{enabled:true}# 自动化浏览file_system:# 文件读写enabled:trueallowed_directories:["~","./projects"]3. 安全与记忆
approvals:mode:"manual"# 高危操作需手动确认memory:memory_enabled:true# 启用 MEMORY.mduser_profile_enabled:true# 启用 USER.md（构建你的画像）五、高级技巧与故障排查
🔑 密钥安全管理（必做！）
- 不要在
config.yaml中写明 API Key！ - 正确做法：使用环境变量
- PowerShell:
[Environment]::SetEnvironmentVariable("OPENROUTER_API_KEY","sk-or-v1-...","User") - WSL2 (Bash):
echo'export OPENROUTER_API_KEY="sk-or-v1-..."'>>~/.bashrc&&source~/.bashrc
- PowerShell:
🐞 常见问题
Q：
hermes命令未识别？
A：检查 PATH，或重启终端。Q：浏览器打不开？
A：确保 Chrome/Edge 已安装，并关闭所有实例后再试。Q：WSL2 中无法联网？
A：检查 Windows 防火墙设置。
六、总结：开启你的 AI 智能体时代
通过本指南，你已在 Windows 上成功部署了Hermes Agent—— 一个能自我进化、自动编程、操控浏览器、理解你习惯的下一代 AI 助手。
下一步行动建议：
- 给它一个复杂任务（如：“分析我上周的支出 CSV 并生成可视化报告”）
- 观察它如何分解步骤、调用工具、甚至自动生成新技能
- 查看
~/.hermes/MEMORY.md，见证它的“成长”
现在，你不再只是在使用 AI，而是在培养一个专属的数字智能体伙伴。