本文内容深度融合相关以下技术相关词的汇，放在文章开头以便于您快速阅读以及学习：

• 平台：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：准备环境（管理员权限）

1. 按 Win + X → 选择 “终端(管理员)”。
2. 执行策略设置（允许脚本运行）：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

步骤 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 向导：

1. 选择 Quick setup
2. 选择 OpenRouter
3. 粘贴 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

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 助手。

下一步行动建议：

1. 给它一个复杂任务（如：“分析我上周的支出 CSV 并生成可视化报告”）
2. 观察它如何分解步骤、调用工具、甚至自动生成新技能
3. 查看 ~/.hermes/MEMORY.md，见证它的“成长”

现在，你不再只是在使用 AI，而是在培养一个专属的数字智能体伙伴。