本文内容深度融合相关以下技术相关词的汇，放在文章开头以便于您快速阅读以及学习：
- 平台：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
| 适用人群 | 新手、快速体验者、非开发者 | 开发者、长期使用者、追求稳定性 |
| 安装速度 | ⚡ 极快（一键脚本） | 中等（需先配置 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：准备环境（管理员权限）
步骤 2：执行官方安装脚本
irm https://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 向导：
- 获取地址：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
sudo apt update && sudo apt install -y python3-pip git curl
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.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: custom
base_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: true
allowed_directories: ["~", "./projects"]
3. 安全与记忆
approvals:
mode: "manual" # 高危操作需手动确认
memory:
memory_enabled: true # 启用 MEMORY.md
user_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
🐞 常见问题
-
Q：hermes 命令未识别？ A：检查 PATH，或重启终端。
-
Q：浏览器打不开？ A：确保 Chrome/Edge 已安装，并关闭所有实例后再试。
-
Q：WSL2 中无法联网？ A：检查 Windows 防火墙设置。
六、总结：开启你的 AI 智能体时代
通过本指南，你已在 Windows 上成功部署了 Hermes Agent —— 一个能自我进化、自动编程、操控浏览器、理解你习惯的下一代 AI 助手。
下一步行动建议：
现在，你不再只是在使用 AI，而是在培养一个专属的数字智能体伙伴。
